mcp-wordpress 1.5.2 → 2.0.0

package/dist/tools/users.js

@@ -1,4 +1,5 @@
 import { getErrorMessage } from "../utils/error.js";
+import { WordPressDataStreamer, StreamingUtils } from "../utils/streaming.js";
 /**
  * Provides tools for managing users on a WordPress site.
  * This class encapsulates tool definitions and their corresponding handlers.
@@ -12,7 +13,13 @@ export class UserTools {
         return [
             {
                 name: "wp_list_users",
-                description: "Lists users from a WordPress site, with filters.",
+                description: "Lists users from a WordPress site with comprehensive filtering and detailed user information including roles, registration dates, and activity status.\n\n" +
+                    "**Usage Examples:**\n" +
+                    "• List all users: `wp_list_users`\n" +
+                    '• Search users: `wp_list_users --search="john"`\n' +
+                    '• Filter by role: `wp_list_users --roles=["editor","author"]`\n' +
+                    '• Find admins: `wp_list_users --roles=["administrator"]`\n' +
+                    '• Combined search: `wp_list_users --search="smith" --roles=["subscriber"]`',
                 parameters: [
                     {
                         name: "search",
@@ -43,7 +50,12 @@ export class UserTools {
             },
             {
                 name: "wp_get_current_user",
-                description: "Retrieves the currently authenticated user.",
+                description: "Retrieves the currently authenticated user with comprehensive profile information including roles, capabilities, and account details.\n\n" +
+                    "**Usage Examples:**\n" +
+                    "• Get current user: `wp_get_current_user`\n" +
+                    "• Check permissions: Use this to verify your current user's capabilities and roles\n" +
+                    "• Account verification: Confirm you're authenticated with the correct account\n" +
+                    "• Profile details: View registration date, email, and user metadata",
                 parameters: [],
                 handler: this.handleGetCurrentUser.bind(this),
             },
@@ -127,10 +139,59 @@ export class UserTools {
             if (users.length === 0) {
                 return "No users found matching the criteria.";
             }
-            const content = `Found ${users.length} users:\n\n` +
+            // Use streaming for large user result sets (>30 users)
+            if (users.length > 30) {
+                const streamResults = [];
+                for await (const result of WordPressDataStreamer.streamUsers(users, {
+                    includeRoles: true,
+                    includeCapabilities: false, // Too verbose for large sets
+                    batchSize: 15,
+                })) {
+                    streamResults.push(result);
+                }
+                return StreamingUtils.formatStreamingResponse(streamResults, "users");
+            }
+            // Enhanced user information with comprehensive details
+            const siteUrl = client.getSiteUrl ? client.getSiteUrl() : "Unknown site";
+            const userCount = users.length;
+            const rolesSummary = users.reduce((acc, u) => {
+                const roles = u.roles || [];
+                roles.forEach((role) => {
+                    acc[role] = (acc[role] || 0) + 1;
+                });
+                return acc;
+            }, {});
+            const metadata = [
+                `👥 **Users Summary**: ${userCount} total users`,
+                `🌐 **Source**: ${siteUrl}`,
+                `📊 **Roles Distribution**: ${Object.entries(rolesSummary)
+                    .map(([role, count]) => `${role}: ${count}`)
+                    .join(", ")}`,
+                `📅 **Retrieved**: ${new Date().toLocaleString()}`,
+            ];
+            const content = metadata.join("\n") +
+                "\n\n" +
                 users
-                    .map((u) => `- ID ${u.id}: **${u.name}** (@${u.slug}) - ${u.email}\n  Roles: ${u.roles?.join(", ") || "N/A"}`)
-                    .join("\n");
+                    .map((u) => {
+                    const registrationDate = u.registered_date
+                        ? new Date(u.registered_date).toLocaleDateString("en-US", {
+                            year: "numeric",
+                            month: "short",
+                            day: "numeric",
+                        })
+                        : "Unknown";
+                    const roles = u.roles?.join(", ") || "No roles";
+                    const description = u.description || "No description";
+                    const displayName = u.name || "No display name";
+                    const userUrl = u.url || "No URL";
+                    return (`- **ID ${u.id}**: ${displayName} (@${u.slug})\n` +
+                        `  📧 Email: ${u.email || "No email"}\n` +
+                        `  🎭 Roles: ${roles}\n` +
+                        `  📅 Registered: ${registrationDate}\n` +
+                        `  🔗 URL: ${userUrl}\n` +
+                        `  📝 Description: ${description}`);
+                })
+                    .join("\n\n");
             return content;
         }
         catch (error) {
@@ -154,11 +215,53 @@ export class UserTools {
     async handleGetCurrentUser(client, params) {
         try {
             const user = await client.getCurrentUser();
-            const content = `**Current User Details (ID: ${user.id})**\n\n` +
-                `- **Name:** ${user.name}\n` +
-                `- **Username:** ${user.slug}\n` +
-                `- **Email:** ${user.email}\n` +
-                `- **Roles:** ${user.roles?.join(", ") || "N/A"}`;
+            const siteUrl = client.getSiteUrl();
+            // Extract meaningful information from capabilities
+            const capabilities = user.capabilities || {};
+            const keyCapabilities = [
+                "edit_posts",
+                "edit_pages",
+                "publish_posts",
+                "publish_pages",
+                "delete_posts",
+                "delete_pages",
+                "manage_categories",
+                "manage_options",
+                "moderate_comments",
+                "upload_files",
+                "edit_others_posts",
+                "delete_others_posts",
+            ];
+            const userCapabilities = keyCapabilities.filter((cap) => capabilities[cap]).join(", ");
+            const totalCapabilities = Object.keys(capabilities).length;
+            // Format registration date more clearly
+            const registrationDate = user.registered_date
+                ? new Date(user.registered_date).toLocaleDateString("en-US", {
+                    year: "numeric",
+                    month: "long",
+                    day: "numeric",
+                })
+                : "Not available";
+            // Extract role information
+            const roles = user.roles || [];
+            const primaryRole = roles[0] || "No role assigned";
+            const allRoles = roles.length > 1 ? roles.join(", ") : primaryRole;
+            // Build comprehensive user information
+            const content = `**Current User Details for ${siteUrl}**\n\n` +
+                `- **ID:** ${user.id}\n` +
+                `- **Display Name:** ${user.name || "Not set"}\n` +
+                `- **Username:** ${user.slug || "Not set"}\n` +
+                `- **Email:** ${user.email || "Not set"}\n` +
+                `- **User URL:** ${user.url || "Not set"}\n` +
+                `- **Nickname:** ${user.nickname || user.name || "Not set"}\n` +
+                `- **Description:** ${user.description || "No description provided"}\n` +
+                `- **Locale:** ${user.locale || "Default"}\n` +
+                `- **Registration Date:** ${registrationDate}\n` +
+                `- **Primary Role:** ${primaryRole}\n` +
+                `- **All Roles:** ${allRoles}\n` +
+                `- **Total Capabilities:** ${totalCapabilities} capabilities\n` +
+                `- **Key Capabilities:** ${userCapabilities || "None"}\n` +
+                `- **Profile Link:** ${user.link || `${siteUrl}/wp-admin/profile.php`}`;
             return content;
         }
         catch (error) {

package/dist/tools/users.js.map

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

package/dist/utils/enhancedError.d.ts

@@ -0,0 +1,61 @@
+export interface ErrorContext {
+    operation: string;
+    parameters?: Record<string, any>;
+    suggestions?: string[];
+    troubleshooting?: string[];
+}
+/**
+ * Enhanced error handling with helpful messages and suggestions
+ */
+export declare class EnhancedError extends Error {
+    suggestions: string[];
+    troubleshooting: string[];
+    context: ErrorContext;
+    constructor(message: string, context: ErrorContext);
+    /**
+     * Format error message with suggestions
+     */
+    toString(): string;
+}
+/**
+ * Common error handlers with context-aware suggestions
+ */
+export declare class ErrorHandlers {
+    /**
+     * Handle post not found errors
+     */
+    static postNotFound(postId: number, originalError: any): EnhancedError;
+    /**
+     * Handle authentication errors
+     */
+    static authenticationFailed(originalError: any): EnhancedError;
+    /**
+     * Handle site parameter missing errors
+     */
+    static siteParameterMissing(availableSites: string[]): EnhancedError;
+    /**
+     * Handle site not found errors
+     */
+    static siteNotFound(siteId: string, availableSites: string[]): EnhancedError;
+    /**
+     * Handle permission errors
+     */
+    static permissionDenied(operation: string, originalError: any): EnhancedError;
+    /**
+     * Handle network/connection errors
+     */
+    static connectionError(originalError: any): EnhancedError;
+    /**
+     * Handle validation errors
+     */
+    static validationError(field: string, value: any, expectedType: string): EnhancedError;
+    /**
+     * Handle rate limiting errors
+     */
+    static rateLimitExceeded(originalError: any): EnhancedError;
+    /**
+     * Generic error handler with basic suggestions
+     */
+    static generic(operation: string, originalError: any): EnhancedError;
+}
+//# sourceMappingURL=enhancedError.d.ts.map

package/dist/utils/enhancedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancedError.d.ts","sourceRoot":"","sources":["../../src/utils/enhancedError.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,YAAY,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY;IAQlD;;OAEG;IACH,QAAQ,IAAI,MAAM;CAmBnB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,aAAa;IAqBtE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,aAAa,EAAE,GAAG,GAAG,aAAa;IAqB9D;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,aAAa;IAgBpE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,aAAa;IAiB5E;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,aAAa;IAmB7E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,aAAa,EAAE,GAAG,GAAG,aAAa;IAmBzD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,GAAG,aAAa;IAiBtF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,aAAa,EAAE,GAAG,GAAG,aAAa;IAmB3D;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,aAAa;CAkBrE"}

package/dist/utils/enhancedError.js

@@ -0,0 +1,221 @@
+import { getErrorMessage } from "./error.js";
+/**
+ * Enhanced error handling with helpful messages and suggestions
+ */
+export class EnhancedError extends Error {
+    suggestions;
+    troubleshooting;
+    context;
+    constructor(message, context) {
+        super(message);
+        this.name = "EnhancedError";
+        this.context = context;
+        this.suggestions = context.suggestions || [];
+        this.troubleshooting = context.troubleshooting || [];
+    }
+    /**
+     * Format error message with suggestions
+     */
+    toString() {
+        let message = `❌ ${this.message}`;
+        if (this.suggestions.length > 0) {
+            message += `\n\n💡 **Suggestions:**\n`;
+            this.suggestions.forEach((suggestion) => {
+                message += `• ${suggestion}\n`;
+            });
+        }
+        if (this.troubleshooting.length > 0) {
+            message += `\n🔧 **Troubleshooting:**\n`;
+            this.troubleshooting.forEach((step) => {
+                message += `• ${step}\n`;
+            });
+        }
+        return message;
+    }
+}
+/**
+ * Common error handlers with context-aware suggestions
+ */
+export class ErrorHandlers {
+    /**
+     * Handle post not found errors
+     */
+    static postNotFound(postId, originalError) {
+        const errorMessage = getErrorMessage(originalError);
+        return new EnhancedError(`Post with ID ${postId} not found`, {
+            operation: "get_post",
+            parameters: { postId },
+            suggestions: [
+                "Check if the post ID is correct",
+                "Verify the post exists and is published",
+                "Try listing posts first with wp_list_posts to see available posts",
+                "Check if you have permission to view this post",
+            ],
+            troubleshooting: [
+                "Use wp_list_posts to see all available posts",
+                "Check the post status - it might be draft, private, or trashed",
+                "Verify your user permissions for viewing posts",
+                `Original error: ${errorMessage}`,
+            ],
+        });
+    }
+    /**
+     * Handle authentication errors
+     */
+    static authenticationFailed(originalError) {
+        const errorMessage = getErrorMessage(originalError);
+        return new EnhancedError("Authentication failed", {
+            operation: "authenticate",
+            suggestions: [
+                "Check your WordPress credentials (username and app password)",
+                "Verify the WordPress site URL is correct",
+                "Ensure application passwords are enabled on your WordPress site",
+                "Try regenerating your application password",
+            ],
+            troubleshooting: [
+                "Go to your WordPress admin → Users → Profile → Application Passwords",
+                "Create a new application password with a descriptive name",
+                "Make sure the WordPress site URL ends with wp-json/wp/v2",
+                "Check if your site has any security plugins blocking REST API",
+                `Original error: ${errorMessage}`,
+            ],
+        });
+    }
+    /**
+     * Handle site parameter missing errors
+     */
+    static siteParameterMissing(availableSites) {
+        return new EnhancedError("Multiple sites configured - site parameter required", {
+            operation: "site_selection",
+            suggestions: [
+                "Add --site parameter to specify which site to use",
+                `Available sites: ${availableSites.join(", ")}`,
+                'Example: wp_list_posts --site="your-site-id"',
+            ],
+            troubleshooting: [
+                "Check your mcp-wordpress.config.json for configured sites",
+                "Use the site ID from your configuration file",
+                "Site IDs are defined in the 'id' field of each site config",
+            ],
+        });
+    }
+    /**
+     * Handle site not found errors
+     */
+    static siteNotFound(siteId, availableSites) {
+        return new EnhancedError(`Site with ID '${siteId}' not found`, {
+            operation: "site_selection",
+            parameters: { siteId },
+            suggestions: [
+                `Available sites: ${availableSites.join(", ")}`,
+                "Check the spelling of the site ID",
+                "Verify the site is configured in mcp-wordpress.config.json",
+            ],
+            troubleshooting: [
+                "Open mcp-wordpress.config.json to see configured sites",
+                "Check the 'id' field for each site configuration",
+                "Ensure the site ID matches exactly (case-sensitive)",
+            ],
+        });
+    }
+    /**
+     * Handle permission errors
+     */
+    static permissionDenied(operation, originalError) {
+        const errorMessage = getErrorMessage(originalError);
+        return new EnhancedError(`Permission denied for ${operation}`, {
+            operation,
+            suggestions: [
+                "Check if your user has the required permissions",
+                "Verify you're logged in with the correct user account",
+                "Contact your WordPress administrator for permission changes",
+            ],
+            troubleshooting: [
+                "Check your user role in WordPress admin → Users",
+                "Verify the required capabilities for this operation",
+                "Try using an administrator account",
+                `Original error: ${errorMessage}`,
+            ],
+        });
+    }
+    /**
+     * Handle network/connection errors
+     */
+    static connectionError(originalError) {
+        const errorMessage = getErrorMessage(originalError);
+        return new EnhancedError("Failed to connect to WordPress site", {
+            operation: "connection",
+            suggestions: [
+                "Check your internet connection",
+                "Verify the WordPress site URL is correct and accessible",
+                "Check if the site is temporarily down",
+            ],
+            troubleshooting: [
+                "Try accessing the site in your browser",
+                "Check if the REST API is enabled: visit yoursite.com/wp-json/",
+                "Verify there are no firewall or security plugins blocking access",
+                `Original error: ${errorMessage}`,
+            ],
+        });
+    }
+    /**
+     * Handle validation errors
+     */
+    static validationError(field, value, expectedType) {
+        return new EnhancedError(`Invalid ${field}: expected ${expectedType}, got ${typeof value}`, {
+            operation: "validation",
+            parameters: { field, value, expectedType },
+            suggestions: [
+                `Provide a valid ${expectedType} for ${field}`,
+                "Check the parameter format and type",
+                "Refer to the tool documentation for correct parameter format",
+            ],
+            troubleshooting: [
+                "Review the tool's parameter requirements",
+                "Check for typos in parameter names",
+                "Ensure parameter values match the expected type",
+            ],
+        });
+    }
+    /**
+     * Handle rate limiting errors
+     */
+    static rateLimitExceeded(originalError) {
+        const errorMessage = getErrorMessage(originalError);
+        return new EnhancedError("Rate limit exceeded", {
+            operation: "rate_limit",
+            suggestions: [
+                "Wait a few minutes before trying again",
+                "Reduce the frequency of requests",
+                "Use pagination for large operations",
+            ],
+            troubleshooting: [
+                "Check your WordPress hosting plan limits",
+                "Consider upgrading your hosting plan for higher limits",
+                "Implement delays between requests",
+                `Original error: ${errorMessage}`,
+            ],
+        });
+    }
+    /**
+     * Generic error handler with basic suggestions
+     */
+    static generic(operation, originalError) {
+        const errorMessage = getErrorMessage(originalError);
+        return new EnhancedError(`Failed to ${operation}`, {
+            operation,
+            suggestions: [
+                "Check your WordPress credentials and permissions",
+                "Verify the site is accessible and functioning",
+                "Try the operation again after a brief wait",
+            ],
+            troubleshooting: [
+                "Test your connection with a simpler operation first",
+                "Check WordPress admin for any issues",
+                "Review the WordPress error logs",
+                `Original error: ${errorMessage}`,
+            ],
+        });
+    }
+}
+//# sourceMappingURL=enhancedError.js.map

package/dist/utils/enhancedError.js.map

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

package/dist/utils/streaming.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Streaming utilities for handling large result sets
+ * Implements streaming responses for better performance and memory usage
+ */
+export interface StreamingOptions {
+    batchSize?: number;
+    delay?: number;
+    transformItem?: (item: any) => any;
+    filterItem?: (item: any) => boolean;
+}
+export interface StreamingResult<T> {
+    data: T[];
+    hasMore: boolean;
+    cursor?: string | undefined;
+    total?: number | undefined;
+    processed: number;
+}
+/**
+ * Creates a streaming response for large datasets
+ */
+export declare class DataStreamer<T> {
+    private batchSize;
+    private delay;
+    private transformItem;
+    private filterItem;
+    constructor(options?: StreamingOptions);
+    /**
+     * Processes data in batches with streaming
+     */
+    streamBatches<U>(data: T[], processor: (batch: T[]) => Promise<U[]>): AsyncGenerator<StreamingResult<U>, void, unknown>;
+    /**
+     * Processes large datasets with pagination
+     */
+    streamPages<U>(fetcher: (page: number, perPage: number) => Promise<{
+        data: T[];
+        hasMore: boolean;
+    }>, processor: (items: T[]) => Promise<U[]>): AsyncGenerator<StreamingResult<U>, void, unknown>;
+}
+/**
+ * Streaming formatter for WordPress data
+ */
+export declare class WordPressDataStreamer {
+    /**
+     * Streams WordPress posts with author and taxonomy information
+     */
+    static streamPosts(posts: any[], options?: {
+        includeAuthor?: boolean;
+        includeCategories?: boolean;
+        includeTags?: boolean;
+        batchSize?: number;
+    }): AsyncGenerator<StreamingResult<any>, void, unknown>;
+    /**
+     * Streams WordPress users with role information
+     */
+    static streamUsers(users: any[], options?: {
+        includeRoles?: boolean;
+        includeCapabilities?: boolean;
+        batchSize?: number;
+    }): AsyncGenerator<StreamingResult<any>, void, unknown>;
+    /**
+     * Streams WordPress comments with moderation status
+     */
+    static streamComments(comments: any[], options?: {
+        includeAuthor?: boolean;
+        includePost?: boolean;
+        batchSize?: number;
+    }): AsyncGenerator<StreamingResult<any>, void, unknown>;
+}
+/**
+ * Utility functions for streaming responses
+ */
+export declare class StreamingUtils {
+    /**
+     * Formats streaming results for display
+     */
+    static formatStreamingResponse(results: StreamingResult<any>[], type?: "posts" | "users" | "comments" | "media"): string;
+    /**
+     * Implements progressive loading for large datasets
+     */
+    static loadProgressively<T>(fetcher: (offset: number, limit: number) => Promise<T[]>, options?: {
+        initialLoad?: number;
+        batchSize?: number;
+        maxItems?: number;
+        onProgress?: (loaded: number, total?: number) => void;
+    }): Promise<T[]>;
+}
+/**
+ * Memory-efficient data processor
+ */
+export declare class MemoryEfficientProcessor {
+    /**
+     * Processes large datasets with memory monitoring
+     */
+    static processLargeDataset<T, U>(dataProvider: () => AsyncGenerator<T[], void, unknown>, processor: (items: T[]) => Promise<U[]>, options?: {
+        maxMemoryUsage?: number;
+        batchSize?: number;
+        onProgress?: (processed: number) => void;
+    }): Promise<U[]>;
+    /**
+     * Helper method to split arrays into chunks
+     */
+    private static chunkArray;
+}
+//# sourceMappingURL=streaming.d.ts.map

package/dist/utils/streaming.d.ts.map

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