@respira/wordpress-mcp-server 6.6.0 → 6.6.5

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAEzE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB,CAAS;IAEpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAW;IAErD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IAuPvE,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,oBAAoB;IAQ5B,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAuIP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IAk5DtB;;;;;;OAMG;IACH,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;YAEpC,oBAAoB;YAqDpB,2BAA2B;IAazC;;;;OAIG;YACW,cAAc;IAY5B,OAAO,CAAC,mBAAmB;YAwTb,cAAc;YAoBd,gBAAgB;IAkkB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuQzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAKV"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAuBzE,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,YAAY,CAA4B;IAChD,8EAA8E;IAC9E,OAAO,CAAC,mBAAmB,CAAS;IAEpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAW;IAErD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IAuPvE,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,oBAAoB;IAQ5B,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YA0LP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IAoiEtB;;;;;;OAMG;IACH,yEAAyE;IACzE,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;YAEpC,oBAAoB;YAqDpB,2BAA2B;IAazC;;;;OAIG;YACW,cAAc;IAY5B,OAAO,CAAC,mBAAmB;YAwTb,cAAc;YAoBd,gBAAgB;IAkkB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuQzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAKV"}

package/dist/server.js

@@ -11,6 +11,27 @@ import { RespiraVersionChecker } from './version-checker.js';
 import { getBricksTools, dispatchBricksTool } from './bricks-tools.js';
 import { getElementorTools, dispatchElementorTool } from './elementor-tools.js';
 import { getAcfTools, ACF_TOOL_NAMES } from './acf-tools.js';
+/**
+ * Thrown by the per-call watchdog when a tool handler exceeds its deadline.
+ * Surfaces as a structured `tool_timeout` response so the stdio loop stays
+ * responsive and every subsequent tool call keeps working.
+ */
+class ToolTimeoutError extends Error {
+    toolName;
+    timeoutMs;
+    constructor(toolName, timeoutMs) {
+        super(`Tool "${toolName}" did not complete within ${timeoutMs}ms. ` +
+            `The WordPress server may be unresponsive, the operation may legitimately take longer than configured, ` +
+            `or the handler may be stuck. Other tools should continue to work. ` +
+            `Raise RESPIRA_MAX_TOOL_TIMEOUT_MS if the operation genuinely needs more time.`);
+        this.toolName = toolName;
+        this.timeoutMs = timeoutMs;
+        this.name = 'ToolTimeoutError';
+    }
+}
+function getMaxToolTimeoutMs() {
+    return Math.max(5000, parseInt(process.env.RESPIRA_MAX_TOOL_TIMEOUT_MS || '120000', 10));
+}
 export class RespiraWordPressServer {
     server;
     currentSite = null;
@@ -22,7 +43,7 @@ export class RespiraWordPressServer {
     allowedSites = null;
     /** Whether the plugin version warning has already been shown this session. */
     versionWarningShown = false;
-    static MCP_SERVER_VERSION = '6.3.0';
+    static MCP_SERVER_VERSION = '6.6.4';
     /**
      * Normalize a tool name: respira_* → wordpress_* for switch dispatch.
      * Tracks whether the deprecated wordpress_* name was used.
@@ -351,9 +372,25 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             if (!this.currentSite) {
                 throw new Error('No WordPress site configured');
             }
+            // Per-call watchdog: a single hung handler must never wedge the stdio
+            // loop for every subsequent tool call. If the deadline fires, the race
+            // rejects with ToolTimeoutError; the losing handler keeps running in
+            // the background but the client gets a clean structured error and the
+            // next tool call is free to proceed.
+            const toolTimeoutMs = getMaxToolTimeoutMs();
+            let timeoutHandle;
+            const toolTimeout = new Promise((_, reject) => {
+                timeoutHandle = setTimeout(() => reject(new ToolTimeoutError(name, toolTimeoutMs)), toolTimeoutMs);
+            });
             try {
                 this.currentSite.setCurrentToolName(name);
-                const result = await this.handleToolCall(name, args || {});
+                const result = await Promise.race([
+                    this.handleToolCall(name, args || {}),
+                    toolTimeout,
+                ]);
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
                 this.currentSite.setCurrentToolName(null);
                 // Handle soft errors (e.g. unknown tool) — return isError without throwing.
                 if (result && result.__respira_is_error) {
@@ -384,7 +421,31 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
                 };
             }
             catch (error) {
+                if (timeoutHandle) {
+                    clearTimeout(timeoutHandle);
+                }
                 this.currentSite?.setCurrentToolName(null);
+                if (error instanceof ToolTimeoutError) {
+                    const activeSite = this.getActiveSiteSummary();
+                    return {
+                        content: [
+                            {
+                                type: 'text',
+                                text: JSON.stringify({
+                                    error: 'tool_timeout',
+                                    tool: error.toolName,
+                                    timeout_ms: error.timeoutMs,
+                                    message: error.message,
+                                    hint: 'Other tools should continue to work. ' +
+                                        'If this operation genuinely needs more time, raise RESPIRA_MAX_TOOL_TIMEOUT_MS. ' +
+                                        'For uploads specifically, also see RESPIRA_UPLOAD_TIMEOUT_MS and RESPIRA_MAX_UPLOAD_MB.',
+                                    site: activeSite,
+                                }, null, 2),
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
                 // Handle Promise objects that weren't awaited (they would have .then method)
                 if (error && typeof error.then === 'function') {
                     // Try to await the Promise to get the actual error
@@ -575,10 +636,15 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             },
             {
                 name: 'wordpress_get_builder_info',
-                description: 'Detect which page builder is active on the site and get its version, support level (Full Intelligence / Smart Defaults / Basic), available modules/widgets, and capabilities. Call this first before working with builder content to understand what format to use.',
+                description: 'Detect which page builder is active on the site and get its version, support level (Full Intelligence / Smart Defaults / Basic), available modules/widgets, and capabilities. Call this first before working with builder content to understand what format to use. Pass debug=true to bypass the cache and include per-builder detection_signals (constants, classes, active plugin slugs, plugin headers, theme) — use this when a builder is installed but reports detected=false.',
                 inputSchema: {
                     type: 'object',
-                    properties: {},
+                    properties: {
+                        debug: {
+                            type: 'boolean',
+                            description: 'When true, bypass the 1-hour detection cache and include detection_signals for each builder that exposes them. Use to diagnose false negatives.',
+                        },
+                    },
                 },
                 readOnlyHint: true,
             },
@@ -752,7 +818,7 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             },
             {
                 name: 'wordpress_read_post',
-                description: 'Get full content of a specific post.',
+                description: 'Get full content of a specific post. Response includes author object ({id, login, display_name}), taxonomies map ({category, post_tag, ...} each with term {id, name, slug}), and featured_media ({id, url}) alongside title/content/slug/status/date/url/meta.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -789,7 +855,7 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             },
             {
                 name: 'wordpress_update_post',
-                description: 'Update a post. When direct editing is enabled and you target an original post, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.',
+                description: 'Update a post. Supports author reassignment, taxonomy terms (categories/tags/custom), and featured media. When direct editing is enabled and you target an original post, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -813,6 +879,49 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
                             type: 'string',
                             description: 'URL slug (post_name). Example: "my-post" produces /my-post/.',
                         },
+                        author: {
+                            description: 'Author (user id or user login). Requires edit_others_posts capability when different from the acting user.',
+                            oneOf: [
+                                { type: 'number' },
+                                { type: 'string' },
+                            ],
+                        },
+                        categories: {
+                            type: 'array',
+                            description: 'Shorthand for the built-in "category" taxonomy. Accepts term ids (number) or slugs/names (string). Replaces existing categories unless append_terms=true.',
+                            items: {
+                                oneOf: [
+                                    { type: 'number' },
+                                    { type: 'string' },
+                                ],
+                            },
+                        },
+                        tags: {
+                            type: 'array',
+                            description: 'Shorthand for the built-in "post_tag" taxonomy. Accepts term ids (number) or slugs/names (string).',
+                            items: {
+                                oneOf: [
+                                    { type: 'number' },
+                                    { type: 'string' },
+                                ],
+                            },
+                        },
+                        taxonomies: {
+                            type: 'object',
+                            description: 'Generic map of taxonomy slug to array of term ids/slugs for custom taxonomies (e.g. product_cat). Example: { "product_cat": [12, "featured"] }.',
+                        },
+                        featuredMedia: {
+                            type: 'number',
+                            description: 'Attachment ID to set as the featured image. Pass 0 to clear.',
+                        },
+                        createMissingTerms: {
+                            type: 'boolean',
+                            description: 'When true, auto-create taxonomy terms that do not exist by name. Default false (strict: unknown slug returns 400).',
+                        },
+                        appendTerms: {
+                            type: 'boolean',
+                            description: 'When true, append to existing taxonomy terms instead of replacing. Default false (replace).',
+                        },
                         customCss: {
                             type: 'string',
                             description: 'Custom CSS for the post. Auto-detects builder: Divi → _et_pb_custom_css, Elementor → _elementor_page_settings.custom_css.',
@@ -882,7 +991,7 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             },
             {
                 name: 'wordpress_upload_media',
-                description: 'Upload a media file (image, document, video) to WordPress. Supports base64 encoded files, file URLs, file paths, or raw SVG markup strings (starting with <svg or <?xml).',
+                description: 'Upload a media file (image, document, video) to WordPress. Supports base64 encoded files, file URLs, file paths, or raw SVG markup strings (starting with <svg or <?xml). Fails fast with a clear error if the file exceeds 50MB (override via RESPIRA_MAX_UPLOAD_MB) or the upload does not complete within 120 seconds (override via RESPIRA_UPLOAD_TIMEOUT_MS).',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -1887,7 +1996,7 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             },
             {
                 name: 'wordpress_list_custom_posts',
-                description: 'List posts of a custom post type.',
+                description: 'List posts of a custom post type. Each row includes author ({id, login, display_name}), taxonomies map, and featured_media alongside id/title/slug/status/date/url.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -1945,13 +2054,13 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             },
             {
                 name: 'wordpress_create_custom_post',
-                description: 'Create a new custom post.',
+                description: 'Create a new post. Supports author, taxonomy terms (categories/tags/custom), and featured media inline so the full "same category and author as X" pattern works in a single call.',
                 inputSchema: {
                     type: 'object',
                     properties: {
                         type: {
                             type: 'string',
-                            description: 'Post type name',
+                            description: 'Post type name (e.g. "post", "page", "product")',
                         },
                         title: {
                             type: 'string',
@@ -1965,13 +2074,68 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
                             type: 'string',
                             description: 'Post status (default: draft)',
                         },
+                        slug: {
+                            type: 'string',
+                            description: 'URL slug (post_name). Example: "my-post" produces /my-post/.',
+                        },
+                        excerpt: {
+                            type: 'string',
+                            description: 'Optional post excerpt.',
+                        },
+                        date: {
+                            type: 'string',
+                            description: 'Optional publish date in YYYY-MM-DD HH:MM:SS (server local time) for backdating.',
+                        },
+                        author: {
+                            description: 'Author (user id or user login). Requires edit_others_posts capability when different from the acting user.',
+                            oneOf: [
+                                { type: 'number' },
+                                { type: 'string' },
+                            ],
+                        },
+                        categories: {
+                            type: 'array',
+                            description: 'Shorthand for the built-in "category" taxonomy. Accepts term ids (number) or slugs/names (string).',
+                            items: {
+                                oneOf: [
+                                    { type: 'number' },
+                                    { type: 'string' },
+                                ],
+                            },
+                        },
+                        tags: {
+                            type: 'array',
+                            description: 'Shorthand for the built-in "post_tag" taxonomy. Accepts term ids (number) or slugs/names (string).',
+                            items: {
+                                oneOf: [
+                                    { type: 'number' },
+                                    { type: 'string' },
+                                ],
+                            },
+                        },
+                        taxonomies: {
+                            type: 'object',
+                            description: 'Generic map of taxonomy slug to array of term ids/slugs for custom taxonomies (e.g. product_cat). Example: { "product_cat": [12, "featured"] }.',
+                        },
+                        featuredMedia: {
+                            type: 'number',
+                            description: 'Attachment ID to set as the featured image.',
+                        },
+                        createMissingTerms: {
+                            type: 'boolean',
+                            description: 'When true, auto-create taxonomy terms that do not exist by name. Default false (strict: unknown slug returns 400 and the post is rolled back).',
+                        },
+                        meta: {
+                            type: 'object',
+                            description: 'Post meta data (map of meta key to value).',
+                        },
                     },
                     required: ['type', 'title'],
                 },
             },
             {
                 name: 'wordpress_update_custom_post',
-                description: 'Update a custom post. When direct editing is enabled and you target an original item, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.',
+                description: 'Update a custom post. Supports author reassignment, taxonomy terms (categories/tags/custom), and featured media. When direct editing is enabled and you target an original item, Respira returns a confirmation_required preflight by default so you can choose live/original or duplicate.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -1999,6 +2163,49 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
                             type: 'string',
                             description: 'URL slug (post_name).',
                         },
+                        author: {
+                            description: 'Author (user id or user login). Requires edit_others_posts capability when different from the acting user.',
+                            oneOf: [
+                                { type: 'number' },
+                                { type: 'string' },
+                            ],
+                        },
+                        categories: {
+                            type: 'array',
+                            description: 'Shorthand for the built-in "category" taxonomy. Accepts term ids (number) or slugs/names (string).',
+                            items: {
+                                oneOf: [
+                                    { type: 'number' },
+                                    { type: 'string' },
+                                ],
+                            },
+                        },
+                        tags: {
+                            type: 'array',
+                            description: 'Shorthand for the built-in "post_tag" taxonomy. Accepts term ids (number) or slugs/names (string).',
+                            items: {
+                                oneOf: [
+                                    { type: 'number' },
+                                    { type: 'string' },
+                                ],
+                            },
+                        },
+                        taxonomies: {
+                            type: 'object',
+                            description: 'Generic map of taxonomy slug to array of term ids/slugs for custom taxonomies.',
+                        },
+                        featuredMedia: {
+                            type: 'number',
+                            description: 'Attachment ID to set as the featured image. Pass 0 to clear.',
+                        },
+                        createMissingTerms: {
+                            type: 'boolean',
+                            description: 'When true, auto-create taxonomy terms that do not exist by name. Default false (strict).',
+                        },
+                        appendTerms: {
+                            type: 'boolean',
+                            description: 'When true, append to existing taxonomy terms instead of replacing. Default false (replace).',
+                        },
                         meta: {
                             type: 'object',
                             description: 'Post meta data (e.g., { "_et_pb_custom_css": "/* CSS */" })',
@@ -2890,7 +3097,7 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
             case 'wordpress_get_theme_docs':
                 return await this.currentSite.getThemeDocs();
             case 'wordpress_get_builder_info':
-                return await this.currentSite.getBuilderInfo();
+                return await this.currentSite.getBuilderInfo({ debug: Boolean(args?.debug) });
             case 'wordpress_list_pages':
                 return await this.currentSite.listPages(args);
             case 'wordpress_read_page':