mcp-wordpress 2.4.2 → 2.5.1

package/dist/src/tools/auth.js

@@ -0,0 +1,133 @@
+import { getErrorMessage } from "../utils/error.js";
+/**
+ * Provides authentication-related tools for WordPress sites.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export class AuthTools {
+    /**
+     * Retrieves the list of authentication tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools() {
+        return [
+            {
+                name: "wp_test_auth",
+                description: "Tests the authentication and connectivity for a configured WordPress site with detailed connection diagnostics.\n\n" +
+                    "**Usage Examples:**\n" +
+                    "• Test connection: `wp_test_auth`\n" +
+                    '• Multi-site test: `wp_test_auth --site="my-site"`\n' +
+                    "• Verify setup: Use this after configuring new credentials\n" +
+                    "• Troubleshoot: Run when experiencing connection issues\n" +
+                    "• Health check: Regular verification of WordPress connectivity",
+                parameters: [], // The 'site' parameter is added dynamically by the server
+                handler: this.handleTestAuth.bind(this),
+            },
+            {
+                name: "wp_get_auth_status",
+                description: "Gets the current authentication status for a configured WordPress site.",
+                parameters: [],
+                handler: this.handleGetAuthStatus.bind(this),
+            },
+            {
+                name: "wp_switch_auth_method",
+                description: "Switches the authentication method for a site for the current session.",
+                parameters: [
+                    {
+                        name: "method",
+                        type: "string",
+                        required: true,
+                        description: "The new authentication method to use.",
+                        enum: ["app-password", "jwt", "basic", "api-key", "cookie"],
+                    },
+                    {
+                        name: "username",
+                        type: "string",
+                        description: "The username for 'app-password' or 'basic' authentication.",
+                    },
+                    {
+                        name: "password",
+                        type: "string",
+                        description: "The Application Password for 'app-password' or password for 'basic' auth.",
+                    },
+                    {
+                        name: "jwt_token",
+                        type: "string",
+                        description: "The token for 'jwt' authentication.",
+                    },
+                ],
+                handler: this.handleSwitchAuthMethod.bind(this),
+            },
+        ];
+    }
+    /**
+     * Handles the 'wp_test_auth' tool request.
+     * It tests the connection and fetches user details upon success.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    async handleTestAuth(client, params) {
+        try {
+            await client.ping();
+            const user = await client.getCurrentUser();
+            const siteConfig = client.config;
+            const content = "✅ **Authentication successful!**\n\n" +
+                `**Site:** ${siteConfig.baseUrl}\n` +
+                `**Method:** ${siteConfig.auth.method}\n` +
+                `**User:** ${user.name} (@${user.slug})\n` +
+                `**Roles:** ${user.roles?.join(", ") || "N/A"}\n\n` +
+                "Your WordPress connection is working properly.";
+            return { content };
+        }
+        catch (error) {
+            throw new Error(`Authentication test failed: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * Handles the 'wp_get_auth_status' tool request.
+     * Reports whether the client is currently authenticated.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    async handleGetAuthStatus(client, params) {
+        try {
+            const isAuthenticated = client.isAuthenticated;
+            const config = client.config;
+            let content = `**Authentication Status for ${config.baseUrl}**\n\n` +
+                `**Authenticated:** ${isAuthenticated ? "✅ Yes" : "❌ No"}\n` +
+                `**Method:** ${config.auth.method}\n`;
+            if (isAuthenticated) {
+                const user = await client.getCurrentUser();
+                content += `**User:** ${user.name} (@${user.slug})\n`;
+            }
+            else {
+                content += "**Status:** Not connected. Use 'wp_test_auth' to connect and verify credentials.";
+            }
+            return { content };
+        }
+        catch (error) {
+            throw new Error(`Failed to get auth status: ${getErrorMessage(error)}`);
+        }
+    }
+    /**
+     * Handles the 'wp_switch_auth_method' tool request.
+     * Updates the client's authentication configuration in memory for the session.
+     * @param client - The WordPressClient instance for the target site.
+     * @param params - The parameters for the tool request, including the new auth details.
+     * @returns A promise that resolves to an MCPToolResponse.
+     */
+    async handleSwitchAuthMethod(client, params) {
+        const { method: _method, username: _username, password: _password, jwt_token: _jwt_token } = params;
+        try {
+            // This functionality is not currently supported as the client
+            // doesn't have an updateAuthConfig method
+            throw new Error("Dynamic authentication method switching is not currently supported. Please update your configuration file and restart the server.");
+        }
+        catch (error) {
+            throw new Error(`Failed to switch auth method: ${getErrorMessage(error)}`);
+        }
+    }
+}
+export default AuthTools;
+//# sourceMappingURL=auth.js.map

package/dist/src/tools/auth.js.map

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

package/dist/src/tools/cache.d.ts

@@ -0,0 +1,260 @@
+/**
+ * Cache management tools for WordPress MCP Server
+ * Provides cache inspection, clearing, and warming capabilities
+ */
+import type { WordPressClient } from "../client/api.js";
+/**
+ * Cache management tools class
+ */
+export declare class CacheTools {
+    private clients;
+    constructor(clients: Map<string, WordPressClient>);
+    /**
+     * Get cache management tools
+     */
+    getTools(): ({
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+        }) => Promise<{
+            caching_enabled: boolean;
+            message: string;
+            cache_stats?: never;
+            invalidation_stats?: never;
+        } | {
+            caching_enabled: boolean;
+            cache_stats: {
+                hits: number;
+                misses: number;
+                hit_rate: string;
+                total_entries: number;
+                evictions: number;
+            };
+            invalidation_stats: {
+                queue_size: number;
+                rules_count: number;
+                processing: boolean;
+            };
+            message?: never;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+            pattern?: string;
+        }) => Promise<{
+            success: boolean;
+            message: string;
+            cleared_entries?: never;
+            pattern?: never;
+        } | {
+            success: boolean;
+            message: string;
+            cleared_entries: number;
+            pattern: string;
+        } | {
+            success: boolean;
+            message: string;
+            cleared_entries: number;
+            pattern?: never;
+        }>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+        }) => Promise<{
+            success: boolean;
+            message: string;
+            cache_entries_after_warming?: never;
+            warmed_data?: never;
+        } | {
+            success: boolean;
+            message: string;
+            cache_entries_after_warming: number;
+            warmed_data: string[];
+        }>;
+    } | {
+        name: string;
+        description: string;
+        parameters: {
+            name: string;
+            type: string;
+            description: string;
+        }[];
+        handler: (params: {
+            site?: string;
+        }) => Promise<{
+            caching_enabled: boolean;
+            message: string;
+            how_to_enable: string;
+            cache_configuration?: never;
+            ttl_presets?: never;
+            current_stats?: never;
+            invalidation_info?: never;
+            performance_benefits?: never;
+        } | {
+            caching_enabled: boolean;
+            cache_configuration: {
+                max_size: string;
+                default_ttl: string;
+                lru_enabled: string;
+                stats_enabled: string;
+            };
+            ttl_presets: {
+                static_data: string;
+                semi_static_data: string;
+                dynamic_data: string;
+                session_data: string;
+                realtime_data: string;
+            };
+            current_stats: {
+                total_entries: number;
+                hit_rate: string;
+                hits: number;
+                misses: number;
+                evictions: number;
+            };
+            invalidation_info: {
+                queue_size: number;
+                rules_registered: number;
+                currently_processing: boolean;
+            };
+            performance_benefits: string[];
+            message?: never;
+            how_to_enable?: never;
+        }>;
+    })[];
+    /**
+     * Get cache statistics
+     */
+    handleGetCacheStats(params: {
+        site?: string;
+    }): Promise<{
+        caching_enabled: boolean;
+        message: string;
+        cache_stats?: never;
+        invalidation_stats?: never;
+    } | {
+        caching_enabled: boolean;
+        cache_stats: {
+            hits: number;
+            misses: number;
+            hit_rate: string;
+            total_entries: number;
+            evictions: number;
+        };
+        invalidation_stats: {
+            queue_size: number;
+            rules_count: number;
+            processing: boolean;
+        };
+        message?: never;
+    }>;
+    /**
+     * Clear cache
+     */
+    handleClearCache(params: {
+        site?: string;
+        pattern?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        cleared_entries?: never;
+        pattern?: never;
+    } | {
+        success: boolean;
+        message: string;
+        cleared_entries: number;
+        pattern: string;
+    } | {
+        success: boolean;
+        message: string;
+        cleared_entries: number;
+        pattern?: never;
+    }>;
+    /**
+     * Warm cache with essential data
+     */
+    handleWarmCache(params: {
+        site?: string;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        cache_entries_after_warming?: never;
+        warmed_data?: never;
+    } | {
+        success: boolean;
+        message: string;
+        cache_entries_after_warming: number;
+        warmed_data: string[];
+    }>;
+    /**
+     * Get detailed cache information
+     */
+    handleGetCacheInfo(params: {
+        site?: string;
+    }): Promise<{
+        caching_enabled: boolean;
+        message: string;
+        how_to_enable: string;
+        cache_configuration?: never;
+        ttl_presets?: never;
+        current_stats?: never;
+        invalidation_info?: never;
+        performance_benefits?: never;
+    } | {
+        caching_enabled: boolean;
+        cache_configuration: {
+            max_size: string;
+            default_ttl: string;
+            lru_enabled: string;
+            stats_enabled: string;
+        };
+        ttl_presets: {
+            static_data: string;
+            semi_static_data: string;
+            dynamic_data: string;
+            session_data: string;
+            realtime_data: string;
+        };
+        current_stats: {
+            total_entries: number;
+            hit_rate: string;
+            hits: number;
+            misses: number;
+            evictions: number;
+        };
+        invalidation_info: {
+            queue_size: number;
+            rules_registered: number;
+            currently_processing: boolean;
+        };
+        performance_benefits: string[];
+        message?: never;
+        how_to_enable?: never;
+    }>;
+    /**
+     * Resolve client from site parameter
+     */
+    private resolveClient;
+}
+export default CacheTools;
+//# sourceMappingURL=cache.d.ts.map

package/dist/src/tools/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/tools/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD;;GAEG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAEzD;;OAEG;IACH,QAAQ;;;;;;;;0BA8D0B;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAkCpB;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;0BAmCpC;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;0BA2Bd;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAnGlD;;OAEG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;IA+BnD;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;IAgClE;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;IAwB/C;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmDlD;;OAEG;IACH,OAAO,CAAC,aAAa;CAoBtB;AAED,eAAe,UAAU,CAAC"}

package/dist/src/tools/cache.js

@@ -0,0 +1,232 @@
+/**
+ * Cache management tools for WordPress MCP Server
+ * Provides cache inspection, clearing, and warming capabilities
+ */
+import { CachedWordPressClient } from "../client/CachedWordPressClient.js";
+import { toolWrapper } from "../utils/toolWrapper.js";
+/**
+ * Cache management tools class
+ */
+export class CacheTools {
+    clients;
+    constructor(clients) {
+        this.clients = clients;
+    }
+    /**
+     * Get cache management tools
+     */
+    getTools() {
+        return [
+            {
+                name: "wp_cache_stats",
+                description: "Get cache statistics for a WordPress site.",
+                parameters: [
+                    {
+                        name: "site",
+                        type: "string",
+                        description: "Site ID to get cache stats for. If not provided, uses default site or fails if multiple sites configured.",
+                    },
+                ],
+                handler: this.handleGetCacheStats.bind(this),
+            },
+            {
+                name: "wp_cache_clear",
+                description: "Clear cache for a WordPress site.",
+                parameters: [
+                    {
+                        name: "site",
+                        type: "string",
+                        description: "Site ID to clear cache for.",
+                    },
+                    {
+                        name: "pattern",
+                        type: "string",
+                        description: 'Optional pattern to clear specific cache entries (e.g., "posts", "categories").',
+                    },
+                ],
+                handler: this.handleClearCache.bind(this),
+            },
+            {
+                name: "wp_cache_warm",
+                description: "Pre-warm cache with essential WordPress data.",
+                parameters: [
+                    {
+                        name: "site",
+                        type: "string",
+                        description: "Site ID to warm cache for.",
+                    },
+                ],
+                handler: this.handleWarmCache.bind(this),
+            },
+            {
+                name: "wp_cache_info",
+                description: "Get detailed cache configuration and status information.",
+                parameters: [
+                    {
+                        name: "site",
+                        type: "string",
+                        description: "Site ID to get cache info for.",
+                    },
+                ],
+                handler: this.handleGetCacheInfo.bind(this),
+            },
+        ];
+    }
+    /**
+     * Get cache statistics
+     */
+    async handleGetCacheStats(params) {
+        return toolWrapper(async () => {
+            const client = this.resolveClient(params.site);
+            if (!(client instanceof CachedWordPressClient)) {
+                return {
+                    caching_enabled: false,
+                    message: "Caching is disabled for this site. Set DISABLE_CACHE=false to enable caching.",
+                };
+            }
+            const stats = client.getCacheStats();
+            return {
+                caching_enabled: true,
+                cache_stats: {
+                    hits: stats.cache.hits,
+                    misses: stats.cache.misses,
+                    hit_rate: Math.round(stats.cache.hitRate * 100) + "%",
+                    total_entries: stats.cache.totalSize,
+                    evictions: stats.cache.evictions,
+                },
+                invalidation_stats: {
+                    queue_size: stats.invalidation.queueSize,
+                    rules_count: stats.invalidation.rulesCount,
+                    processing: stats.invalidation.processing,
+                },
+            };
+        });
+    }
+    /**
+     * Clear cache
+     */
+    async handleClearCache(params) {
+        return toolWrapper(async () => {
+            const client = this.resolveClient(params.site);
+            if (!(client instanceof CachedWordPressClient)) {
+                return {
+                    success: false,
+                    message: "Caching is not enabled for this site.",
+                };
+            }
+            let cleared;
+            if (params.pattern) {
+                cleared = client.clearCachePattern(params.pattern);
+                return {
+                    success: true,
+                    message: `Cleared ${cleared} cache entries matching pattern "${params.pattern}".`,
+                    cleared_entries: cleared,
+                    pattern: params.pattern,
+                };
+            }
+            else {
+                cleared = client.clearCache();
+                return {
+                    success: true,
+                    message: `Cleared all cache entries (${cleared} total).`,
+                    cleared_entries: cleared,
+                };
+            }
+        });
+    }
+    /**
+     * Warm cache with essential data
+     */
+    async handleWarmCache(params) {
+        return toolWrapper(async () => {
+            const client = this.resolveClient(params.site);
+            if (!(client instanceof CachedWordPressClient)) {
+                return {
+                    success: false,
+                    message: "Caching is not enabled for this site.",
+                };
+            }
+            await client.warmCache();
+            const stats = client.getCacheStats();
+            return {
+                success: true,
+                message: "Cache warmed with essential WordPress data.",
+                cache_entries_after_warming: stats.cache.totalSize,
+                warmed_data: ["Current user information", "Categories", "Tags", "Site settings"],
+            };
+        });
+    }
+    /**
+     * Get detailed cache information
+     */
+    async handleGetCacheInfo(params) {
+        return toolWrapper(async () => {
+            const client = this.resolveClient(params.site);
+            if (!(client instanceof CachedWordPressClient)) {
+                return {
+                    caching_enabled: false,
+                    message: "Caching is disabled for this site.",
+                    how_to_enable: "Remove DISABLE_CACHE=true from environment variables or set it to false.",
+                };
+            }
+            const stats = client.getCacheStats();
+            return {
+                caching_enabled: true,
+                cache_configuration: {
+                    max_size: "Configured in SecurityConfig.cache.maxSize",
+                    default_ttl: "Configured in SecurityConfig.cache.defaultTTL",
+                    lru_enabled: "Configured in SecurityConfig.cache.enableLRU",
+                    stats_enabled: "Configured in SecurityConfig.cache.enableStats",
+                },
+                ttl_presets: {
+                    static_data: "4 hours (site settings, user roles)",
+                    semi_static_data: "2 hours (categories, tags, user profiles)",
+                    dynamic_data: "15 minutes (posts, pages, comments)",
+                    session_data: "30 minutes (authentication, current user)",
+                    realtime_data: "1 minute (real-time data)",
+                },
+                current_stats: {
+                    total_entries: stats.cache.totalSize,
+                    hit_rate: Math.round(stats.cache.hitRate * 100) + "%",
+                    hits: stats.cache.hits,
+                    misses: stats.cache.misses,
+                    evictions: stats.cache.evictions,
+                },
+                invalidation_info: {
+                    queue_size: stats.invalidation.queueSize,
+                    rules_registered: stats.invalidation.rulesCount,
+                    currently_processing: stats.invalidation.processing,
+                },
+                performance_benefits: [
+                    "Reduced API calls to WordPress",
+                    "Faster response times for repeated requests",
+                    "Better rate limit utilization",
+                    "Improved user experience",
+                ],
+            };
+        });
+    }
+    /**
+     * Resolve client from site parameter
+     */
+    resolveClient(siteId) {
+        if (!siteId) {
+            if (this.clients.size === 1) {
+                return Array.from(this.clients.values())[0];
+            }
+            else if (this.clients.size === 0) {
+                throw new Error("No WordPress sites configured.");
+            }
+            else {
+                throw new Error(`Multiple sites configured. Please specify --site parameter. Available sites: ${Array.from(this.clients.keys()).join(", ")}`);
+            }
+        }
+        const client = this.clients.get(siteId);
+        if (!client) {
+            throw new Error(`Site "${siteId}" not found. Available sites: ${Array.from(this.clients.keys()).join(", ")}`);
+        }
+        return client;
+    }
+}
+export default CacheTools;
+//# sourceMappingURL=cache.js.map

package/dist/src/tools/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/tools/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,UAAU;IACD;IAApB,YAAoB,OAAqC;QAArC,YAAO,GAAP,OAAO,CAA8B;IAAG,CAAC;IAE7D;;OAEG;IACH,QAAQ;QACN,OAAO;YACL;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,4CAA4C;gBACzD,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EACT,2GAA2G;qBAC9G;iBACF;gBACD,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC7C;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EAAE,mCAAmC;gBAChD,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,6BAA6B;qBAC3C;oBACD;wBACE,IAAI,EAAE,SAAS;wBACf,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iFAAiF;qBAC/F;iBACF;gBACD,OAAO,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC1C;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,+CAA+C;gBAC5D,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4BAA4B;qBAC1C;iBACF;gBACD,OAAO,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;aACzC;YACD;gBACE,IAAI,EAAE,eAAe;gBACrB,WAAW,EAAE,0DAA0D;gBACvE,UAAU,EAAE;oBACV;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,gCAAgC;qBAC9C;iBACF;gBACD,OAAO,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;aAC5C;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,MAAyB;QACjD,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE/C,IAAI,CAAC,CAAC,MAAM,YAAY,qBAAqB,CAAC,EAAE,CAAC;gBAC/C,OAAO;oBACL,eAAe,EAAE,KAAK;oBACtB,OAAO,EAAE,+EAA+E;iBACzF,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;YAErC,OAAO;gBACL,eAAe,EAAE,IAAI;gBACrB,WAAW,EAAE;oBACX,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;oBACtB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;oBAC1B,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG;oBACrD,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;oBACpC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;iBACjC;gBACD,kBAAkB,EAAE;oBAClB,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,SAAS;oBACxC,WAAW,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU;oBAC1C,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU;iBAC1C;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAA2C;QAChE,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE/C,IAAI,CAAC,CAAC,MAAM,YAAY,qBAAqB,CAAC,EAAE,CAAC;gBAC/C,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,uCAAuC;iBACjD,CAAC;YACJ,CAAC;YAED,IAAI,OAAe,CAAC;YAEpB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,GAAG,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACnD,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,WAAW,OAAO,oCAAoC,MAAM,CAAC,OAAO,IAAI;oBACjF,eAAe,EAAE,OAAO;oBACxB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,8BAA8B,OAAO,UAAU;oBACxD,eAAe,EAAE,OAAO;iBACzB,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,MAAyB;QAC7C,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE/C,IAAI,CAAC,CAAC,MAAM,YAAY,qBAAqB,CAAC,EAAE,CAAC;gBAC/C,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,OAAO,EAAE,uCAAuC;iBACjD,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;YAEzB,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;YAErC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,6CAA6C;gBACtD,2BAA2B,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;gBAClD,WAAW,EAAE,CAAC,0BAA0B,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe,CAAC;aACjF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,MAAyB;QAChD,OAAO,WAAW,CAAC,KAAK,IAAI,EAAE;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE/C,IAAI,CAAC,CAAC,MAAM,YAAY,qBAAqB,CAAC,EAAE,CAAC;gBAC/C,OAAO;oBACL,eAAe,EAAE,KAAK;oBACtB,OAAO,EAAE,oCAAoC;oBAC7C,aAAa,EAAE,0EAA0E;iBAC1F,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;YAErC,OAAO;gBACL,eAAe,EAAE,IAAI;gBACrB,mBAAmB,EAAE;oBACnB,QAAQ,EAAE,4CAA4C;oBACtD,WAAW,EAAE,+CAA+C;oBAC5D,WAAW,EAAE,8CAA8C;oBAC3D,aAAa,EAAE,gDAAgD;iBAChE;gBACD,WAAW,EAAE;oBACX,WAAW,EAAE,qCAAqC;oBAClD,gBAAgB,EAAE,2CAA2C;oBAC7D,YAAY,EAAE,qCAAqC;oBACnD,YAAY,EAAE,2CAA2C;oBACzD,aAAa,EAAE,2BAA2B;iBAC3C;gBACD,aAAa,EAAE;oBACb,aAAa,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;oBACpC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG;oBACrD,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;oBACtB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM;oBAC1B,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS;iBACjC;gBACD,iBAAiB,EAAE;oBACjB,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,SAAS;oBACxC,gBAAgB,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU;oBAC/C,oBAAoB,EAAE,KAAK,CAAC,YAAY,CAAC,UAAU;iBACpD;gBACD,oBAAoB,EAAE;oBACpB,gCAAgC;oBAChC,6CAA6C;oBAC7C,+BAA+B;oBAC/B,0BAA0B;iBAC3B;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,MAAe;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBAC5B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC;iBAAM,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CACb,gFAAgF,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7H,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,SAAS,MAAM,iCAAiC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,eAAe,UAAU,CAAC"}

package/dist/src/tools/comments.d.ts

@@ -0,0 +1,33 @@
+import { WordPressClient } from "../client/api.js";
+/**
+ * Provides tools for managing comments on a WordPress site.
+ * This class encapsulates tool definitions and their corresponding handlers.
+ */
+export declare class CommentTools {
+    /**
+     * Retrieves the list of comment management tools.
+     * @returns An array of MCPTool definitions.
+     */
+    getTools(): Array<{
+        name: string;
+        description: string;
+        parameters?: Array<{
+            name: string;
+            type?: string;
+            description?: string;
+            required?: boolean;
+            enum?: string[];
+            items?: unknown;
+        }>;
+        handler: (client: WordPressClient, params: Record<string, unknown>) => Promise<unknown>;
+    }>;
+    handleListComments(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+    handleGetComment(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+    handleCreateComment(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+    handleUpdateComment(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+    handleDeleteComment(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+    handleApproveComment(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+    handleSpamComment(client: WordPressClient, params: Record<string, unknown>): Promise<unknown>;
+}
+export default CommentTools;
+//# sourceMappingURL=comments.d.ts.map

package/dist/src/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAInD;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;OAGG;IACI,QAAQ,IAAI,KAAK,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAChI,OAAO,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KACzF,CAAC;IAqIW,kBAAkB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB9F,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5F,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/F,mBAAmB,CAC9B,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAUN,mBAAmB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAW/F,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAahG,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;CAY3G;AAED,eAAe,YAAY,CAAC"}