bn-slack-mcp-server 0.0.1

package/dist/schemas.js.map

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

package/dist/slack-api-client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Slack API Client
+ *
+ * Stateless HTTP client for Slack Web API with Bearer token authentication.
+ * Extracts token from Express request headers for per-request auth.
+ */
+import type { Request } from "express";
+import type { SlackApiResponse, SlackUser, SlackChannel } from "./types.js";
+/**
+ * Extract Bearer token from request Authorization header
+ */
+export declare function getTokenFromRequest(req: Request): string;
+/**
+ * Slack API client class with caching support
+ */
+export declare class SlackClient {
+    private token;
+    private headers;
+    usersCacheFile: string;
+    channelsCacheFile: string;
+    constructor(token: string);
+    /**
+     * Make GET request to Slack API
+     */
+    makeRequest<T = SlackApiResponse>(endpoint: string, params?: Record<string, string | number | boolean>): Promise<T>;
+    /**
+     * Make POST request to Slack API
+     */
+    postRequest<T = SlackApiResponse>(endpoint: string, body?: Record<string, unknown>): Promise<T>;
+    /**
+     * Get users with caching support
+     */
+    getCachedUsers(cacheDurationHours?: number): Promise<SlackUser[]>;
+    /**
+     * Get channels with caching support and graceful permission handling
+     */
+    getCachedChannels(cacheDurationHours?: number): Promise<SlackChannel[]>;
+    /**
+     * Resolve channel name/mention to channel ID
+     */
+    resolveChannelId(channelInput: string): Promise<string>;
+    /**
+     * Resolve user name/mention to user ID
+     */
+    resolveUserId(userInput: string): Promise<string>;
+}
+/**
+ * Get Slack client from Express request
+ */
+export declare function getSlackClient(req: Request): SlackClient;
+//# sourceMappingURL=slack-api-client.d.ts.map

package/dist/slack-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-api-client.d.ts","sourceRoot":"","sources":["../src/slack-api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM5E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQxD;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAyB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;gBAErB,KAAK,EAAE,MAAM;IAiBzB;;OAEG;IACG,WAAW,CAAC,CAAC,GAAG,gBAAgB,EACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAM,GACrD,OAAO,CAAC,CAAC,CAAC;IA8Bb;;OAEG;IACG,WAAW,CAAC,CAAC,GAAG,gBAAgB,EACpC,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,CAAC,CAAC;IAwBb;;OAEG;IACG,cAAc,CAAC,kBAAkB,SAAK,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAqBnE;;OAEG;IACG,iBAAiB,CAAC,kBAAkB,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsCxE;;OAEG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiE7D;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA2BxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW,CAGxD"}

package/dist/slack-api-client.js

@@ -0,0 +1,227 @@
+/**
+ * Slack API Client
+ *
+ * Stateless HTTP client for Slack Web API with Bearer token authentication.
+ * Extracts token from Express request headers for per-request auth.
+ */
+import { loadCache, saveCache, isCacheFresh, getCacheDir } from "./helpers.js";
+import { resolve } from "path";
+const SLACK_API_BASE = "https://slack.com/api";
+/**
+ * Extract Bearer token from request Authorization header
+ */
+export function getTokenFromRequest(req) {
+    const authHeader = req.headers.authorization;
+    if (!authHeader || !authHeader.startsWith("Bearer ")) {
+        throw new Error("Authentication required. Please provide Authorization: Bearer <token> header");
+    }
+    return authHeader.slice(7);
+}
+/**
+ * Slack API client class with caching support
+ */
+export class SlackClient {
+    token;
+    headers;
+    usersCacheFile;
+    channelsCacheFile;
+    constructor(token) {
+        this.token = token;
+        this.headers = {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json; charset=utf-8",
+        };
+        // Cache configuration from environment variables with defaults
+        const cacheDir = getCacheDir();
+        this.usersCacheFile =
+            process.env.SLACK_MCP_USERS_CACHE ||
+                resolve(cacheDir, "users_cache.json");
+        this.channelsCacheFile =
+            process.env.SLACK_MCP_CHANNELS_CACHE ||
+                resolve(cacheDir, "channels_cache_v2.json");
+    }
+    /**
+     * Make GET request to Slack API
+     */
+    async makeRequest(endpoint, params = {}) {
+        const url = new URL(`${SLACK_API_BASE}/${endpoint}`);
+        // Add query parameters
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined && value !== null) {
+                url.searchParams.append(key, String(value));
+            }
+        }
+        const response = await fetch(url.toString(), {
+            method: "GET",
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            throw new Error(`Slack API error: ${response.status} - ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.ok) {
+            throw new Error(`Slack API error: ${data.error || "Unknown error"}`);
+        }
+        return data;
+    }
+    /**
+     * Make POST request to Slack API
+     */
+    async postRequest(endpoint, body = {}) {
+        const url = `${SLACK_API_BASE}/${endpoint}`;
+        const response = await fetch(url, {
+            method: "POST",
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            throw new Error(`Slack API error: ${response.status} - ${response.statusText}`);
+        }
+        const data = (await response.json());
+        if (!data.ok) {
+            throw new Error(`Slack API error: ${data.error || "Unknown error"}`);
+        }
+        return data;
+    }
+    /**
+     * Get users with caching support
+     */
+    async getCachedUsers(cacheDurationHours = 24) {
+        // Check if cache is fresh
+        if (isCacheFresh(this.usersCacheFile, cacheDurationHours)) {
+            const cached = loadCache(this.usersCacheFile);
+            if (cached) {
+                return cached;
+            }
+        }
+        // Fetch fresh data from API
+        const data = await this.makeRequest("users.list", {
+            limit: 999,
+        });
+        const users = data.members || [];
+        // Save to cache
+        saveCache(this.usersCacheFile, users);
+        return users;
+    }
+    /**
+     * Get channels with caching support and graceful permission handling
+     */
+    async getCachedChannels(cacheDurationHours = 6) {
+        // Check if cache is fresh
+        if (isCacheFresh(this.channelsCacheFile, cacheDurationHours)) {
+            const cached = loadCache(this.channelsCacheFile);
+            if (cached) {
+                return cached;
+            }
+        }
+        // Fetch fresh data from API for all channel types
+        const allChannels = [];
+        const channelTypes = ["public_channel", "private_channel", "im", "mpim"];
+        for (const channelType of channelTypes) {
+            try {
+                const data = await this.makeRequest("conversations.list", {
+                    types: channelType,
+                    limit: 999,
+                });
+                const channels = data.channels || [];
+                allChannels.push(...channels);
+            }
+            catch {
+                // Skip channel types we don't have permission for
+                continue;
+            }
+        }
+        // Save to cache
+        if (allChannels.length > 0) {
+            saveCache(this.channelsCacheFile, allChannels);
+        }
+        return allChannels;
+    }
+    /**
+     * Resolve channel name/mention to channel ID
+     */
+    async resolveChannelId(channelInput) {
+        // Return as-is if already a valid channel ID format
+        if (channelInput.startsWith("C") && channelInput.length === 11) {
+            return channelInput;
+        }
+        // Also accept D (DM) and G (group) IDs
+        if ((channelInput.startsWith("D") || channelInput.startsWith("G")) &&
+            channelInput.length === 11) {
+            return channelInput;
+        }
+        // Load cached channels
+        const channels = await this.getCachedChannels();
+        // Handle #channel format
+        if (channelInput.startsWith("#")) {
+            const channelName = channelInput.slice(1);
+            for (const channel of channels) {
+                if (channel.name === channelName) {
+                    return channel.id;
+                }
+            }
+        }
+        // Handle @user_dm format for direct messages
+        if (channelInput.startsWith("@")) {
+            const userName = channelInput
+                .slice(1)
+                .replace("_dm", "")
+                .replace("_group", "");
+            // For DMs, find the user and open a conversation
+            const users = await this.getCachedUsers();
+            for (const user of users) {
+                if (user.name === userName ||
+                    user.profile?.display_name === userName ||
+                    user.real_name === userName) {
+                    try {
+                        const dmData = await this.postRequest("conversations.open", { users: user.id });
+                        return dmData.channel.id;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+            }
+        }
+        // Try direct name match for channels
+        for (const channel of channels) {
+            if (channel.name === channelInput) {
+                return channel.id;
+            }
+        }
+        // Return as-is if no resolution found
+        return channelInput;
+    }
+    /**
+     * Resolve user name/mention to user ID
+     */
+    async resolveUserId(userInput) {
+        // Return as-is if already a valid user ID format
+        if (userInput.startsWith("U") && userInput.length === 11) {
+            return userInput;
+        }
+        // Load cached users
+        const users = await this.getCachedUsers();
+        // Handle @username format
+        const userName = userInput.startsWith("@") ? userInput.slice(1) : userInput;
+        // Search for user by various name fields
+        for (const user of users) {
+            if (user.name === userName ||
+                user.profile?.display_name === userName ||
+                user.real_name === userName ||
+                user.profile?.real_name === userName) {
+                return user.id;
+            }
+        }
+        // Return as-is if no resolution found
+        return userInput;
+    }
+}
+/**
+ * Get Slack client from Express request
+ */
+export function getSlackClient(req) {
+    const token = getTokenFromRequest(req);
+    return new SlackClient(token);
+}
+//# sourceMappingURL=slack-api-client.js.map

package/dist/slack-api-client.js.map

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

package/dist/tool-loader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tool configuration loader
+ * Loads tool definitions from tools.json and validates them
+ *
+ * Supports loading from (in priority order):
+ * 1. Custom path via TOOLS_CONFIG_PATH environment variable
+ * 2. tools.json in current working directory (for development)
+ * 3. tools.json in package installation directory (for npx/installed usage)
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export interface ToolsConfig {
+    [toolName: string]: ToolDefinition;
+}
+/**
+ * Load tool definitions from tools.json
+ * Uses caching in production, always reloads in development
+ */
+export declare function loadToolDefinitions(forceReload?: boolean): ToolDefinition[];
+/**
+ * Get a specific tool definition by name
+ */
+export declare function getToolDefinition(toolName: string): ToolDefinition | undefined;
+/**
+ * Clear the tool cache (useful for testing or forced reloads)
+ */
+export declare function clearToolCache(): void;
+//# sourceMappingURL=tool-loader.d.ts.map

package/dist/tool-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-loader.d.ts","sourceRoot":"","sources":["../src/tool-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC;CACpC;AAmDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,UAAQ,GAAG,cAAc,EAAE,CAwDzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAIrC"}

package/dist/tool-loader.js

@@ -0,0 +1,121 @@
+/**
+ * Tool configuration loader
+ * Loads tool definitions from tools.json and validates them
+ *
+ * Supports loading from (in priority order):
+ * 1. Custom path via TOOLS_CONFIG_PATH environment variable
+ * 2. tools.json in current working directory (for development)
+ * 3. tools.json in package installation directory (for npx/installed usage)
+ */
+import { readFileSync, existsSync } from "fs";
+import { resolve, isAbsolute, dirname } from "path";
+import { homedir } from "os";
+import { fileURLToPath } from "url";
+let cachedTools = null;
+let lastLoadTime = 0;
+let lastLoadPath = "";
+/**
+ * Resolve the tools configuration file path
+ * Supports:
+ * - Environment variable: TOOLS_CONFIG_PATH
+ * - Absolute paths: /Users/username/Desktop/tools.json
+ * - Relative paths: ./tools.json, ../config/tools.json
+ * - Home directory: ~/Desktop/tools.json
+ * - Default: tools.json in current working directory
+ * - Fallback: tools.json in package installation directory
+ */
+function resolveToolsPath() {
+    // Check environment variable first
+    const envPath = process.env.TOOLS_CONFIG_PATH;
+    if (envPath) {
+        // Expand ~ to home directory
+        const expandedPath = envPath.startsWith("~/")
+            ? resolve(homedir(), envPath.slice(2))
+            : envPath;
+        // If absolute path, use as-is
+        if (isAbsolute(expandedPath)) {
+            return expandedPath;
+        }
+        // Otherwise resolve relative to current working directory
+        return resolve(process.cwd(), expandedPath);
+    }
+    // Try current working directory first (for dev mode)
+    const cwdPath = resolve(process.cwd(), "tools.json");
+    if (existsSync(cwdPath)) {
+        return cwdPath;
+    }
+    // Fallback: tools.json in package installation directory (for npx/installed usage)
+    // Get the directory of this module file
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    // Go up from dist/tool-loader.js to package root
+    const packageRoot = resolve(moduleDir, "..");
+    const packagePath = resolve(packageRoot, "tools.json");
+    return packagePath;
+}
+/**
+ * Load tool definitions from tools.json
+ * Uses caching in production, always reloads in development
+ */
+export function loadToolDefinitions(forceReload = false) {
+    const isDev = process.env.NODE_ENV !== "production";
+    const now = Date.now();
+    // Get the tools config path
+    const toolsPath = resolveToolsPath();
+    // In production, cache tools and only reload if forced or path changed
+    // In development, reload every time (for nodemon compatibility)
+    if (!isDev && !forceReload && cachedTools && (now - lastLoadTime) < 60000 && lastLoadPath === toolsPath) {
+        return cachedTools;
+    }
+    try {
+        // Check if file exists
+        if (!existsSync(toolsPath)) {
+            throw new Error(`Tools configuration file not found: ${toolsPath}`);
+        }
+        const toolsJson = readFileSync(toolsPath, "utf-8");
+        const toolsConfig = JSON.parse(toolsJson);
+        // Convert config object to array of tool definitions
+        const tools = Object.values(toolsConfig);
+        // Validate tool definitions
+        for (const tool of tools) {
+            if (!tool.name || !tool.description || !tool.inputSchema) {
+                throw new Error(`Invalid tool definition: ${JSON.stringify(tool)}`);
+            }
+        }
+        cachedTools = tools;
+        lastLoadTime = now;
+        lastLoadPath = toolsPath;
+        console.log(`[Tool Loader] Loaded ${tools.length} tool definitions from: ${toolsPath}`);
+        if (isDev) {
+            console.log(`[Tool Loader] Development mode: tools will be reloaded on server restart`);
+        }
+        if (process.env.TOOLS_CONFIG_PATH) {
+            console.log(`[Tool Loader] Using custom config path from TOOLS_CONFIG_PATH`);
+        }
+        return tools;
+    }
+    catch (error) {
+        console.error("[Tool Loader] Error loading tools.json:", error);
+        // In case of error, return cached tools if available
+        if (cachedTools) {
+            console.warn("[Tool Loader] Using cached tool definitions due to load error");
+            return cachedTools;
+        }
+        throw new Error(`Failed to load tool definitions: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+/**
+ * Get a specific tool definition by name
+ */
+export function getToolDefinition(toolName) {
+    const tools = loadToolDefinitions();
+    return tools.find(tool => tool.name === toolName);
+}
+/**
+ * Clear the tool cache (useful for testing or forced reloads)
+ */
+export function clearToolCache() {
+    cachedTools = null;
+    lastLoadTime = 0;
+    console.log("[Tool Loader] Tool cache cleared");
+}
+//# sourceMappingURL=tool-loader.js.map

package/dist/tool-loader.js.map

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

package/dist/tool-registry.d.ts

@@ -0,0 +1,44 @@
+import type { Request } from "express";
+import type { z } from "zod";
+import type { ToolResponse } from "./types.js";
+type ToolHandler = (req: Request, args: any) => Promise<any>;
+type ToolSchema = z.ZodSchema<any>;
+/**
+ * Registry for managing and executing MCP tools with automatic debug wrapping
+ */
+export declare class ToolRegistry {
+    private tools;
+    /**
+     * Register a new tool in the registry
+     *
+     * @param name - Unique name of the tool
+     * @param schema - Zod schema for validating tool input
+     * @param handler - Async function that executes the tool logic
+     */
+    register(name: string, schema: ToolSchema, handler: ToolHandler): void;
+    /**
+     * Execute a tool by name with automatic validation and debug wrapping
+     *
+     * @param toolName - Name of the tool to execute
+     * @param rawInput - Raw input arguments (will be validated against schema)
+     * @param req - Express request object for accessing headers/context
+     * @returns ToolResponse with data and optional debug metadata
+     * @throws Error if tool is not found or validation fails
+     */
+    execute(toolName: string, rawInput: unknown, req: Request): Promise<ToolResponse<any>>;
+    /**
+     * Check if a tool exists in the registry
+     *
+     * @param toolName - Name of the tool to check
+     * @returns True if the tool is registered
+     */
+    has(toolName: string): boolean;
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of registered tool names
+     */
+    getToolNames(): string[];
+}
+export {};
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/C,KAAK,WAAW,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAE7D,KAAK,UAAU,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAWnC;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAElD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAItE;;;;;;;;OAQG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,OAAO,GAEX,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IAc7B;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACH,YAAY,IAAI,MAAM,EAAE;CAGzB"}

package/dist/tool-registry.js

@@ -0,0 +1,56 @@
+import { wrapWithDebug } from "./debug-middleware.js";
+/**
+ * Registry for managing and executing MCP tools with automatic debug wrapping
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /**
+     * Register a new tool in the registry
+     *
+     * @param name - Unique name of the tool
+     * @param schema - Zod schema for validating tool input
+     * @param handler - Async function that executes the tool logic
+     */
+    register(name, schema, handler) {
+        this.tools.set(name, { name, schema, handler });
+    }
+    /**
+     * Execute a tool by name with automatic validation and debug wrapping
+     *
+     * @param toolName - Name of the tool to execute
+     * @param rawInput - Raw input arguments (will be validated against schema)
+     * @param req - Express request object for accessing headers/context
+     * @returns ToolResponse with data and optional debug metadata
+     * @throws Error if tool is not found or validation fails
+     */
+    async execute(toolName, rawInput, req
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    ) {
+        const tool = this.tools.get(toolName);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${toolName}`);
+        }
+        // Validate input against schema
+        const args = tool.schema.parse(rawInput);
+        // Execute with debug wrapping
+        return wrapWithDebug(toolName, args, () => tool.handler(req, args));
+    }
+    /**
+     * Check if a tool exists in the registry
+     *
+     * @param toolName - Name of the tool to check
+     * @returns True if the tool is registered
+     */
+    has(toolName) {
+        return this.tools.has(toolName);
+    }
+    /**
+     * Get all registered tool names
+     *
+     * @returns Array of registered tool names
+     */
+    getToolNames() {
+        return Array.from(this.tools.keys());
+    }
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAiBtD;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD;;;;;;OAMG;IACH,QAAQ,CAAC,IAAY,EAAE,MAAkB,EAAE,OAAoB;QAC7D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,QAAiB,EACjB,GAAY;IACZ,8DAA8D;;QAE9D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,gCAAgC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEzC,8BAA8B;QAC9B,OAAO,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/tools/cache.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Cache tool handlers for Slack MCP Server
+ */
+import type { Request } from "express";
+import type { z } from "zod";
+import type { InitializeCacheSchema, CacheInfoSchema, ClearCacheSchema } from "../schemas.js";
+/**
+ * Initialize both user and channel caches by fetching fresh data
+ */
+export declare function initializeCache(req: Request, _args: z.infer<typeof InitializeCacheSchema>): Promise<{
+    success: boolean;
+    message: string;
+    users_cache: {
+        path: string;
+        size_kb: number;
+        count: number;
+    };
+    channels_cache: {
+        path: string;
+        size_kb: number;
+        count: number;
+    };
+    total_cache_size_kb: number;
+}>;
+/**
+ * Get information about cache file locations, sizes, and last updated times
+ */
+export declare function cacheInfo(req: Request, _args: z.infer<typeof CacheInfoSchema>): Promise<{
+    success: boolean;
+    cache_directory: string;
+    users_cache: {
+        exists: boolean;
+        absolute_path: string;
+        size_bytes: number;
+        size_kb: number;
+        last_modified: string | null;
+        age_hours: number | null;
+        is_fresh: boolean;
+        configured_path: string;
+    };
+    channels_cache: {
+        exists: boolean;
+        absolute_path: string;
+        size_bytes: number;
+        size_kb: number;
+        last_modified: string | null;
+        age_hours: number | null;
+        is_fresh: boolean;
+        configured_path: string;
+    };
+    environment_variables: {
+        SLACK_MCP_USERS_CACHE: string;
+        SLACK_MCP_CHANNELS_CACHE: string;
+    };
+    recommendations: {
+        users_cache_fresh: boolean;
+        channels_cache_fresh: boolean;
+        total_cache_size_kb: number;
+    };
+}>;
+/**
+ * Clear cache files to force refresh from Slack API
+ */
+export declare function clearCache(req: Request, args: z.infer<typeof ClearCacheSchema>): Promise<{
+    success: boolean;
+    cleared: string[];
+    message: string;
+}>;
+//# sourceMappingURL=cache.d.ts.map