@respira/wordpress-mcp-server 6.11.0 → 6.11.2

package/README.md

@@ -602,6 +602,34 @@ Or install globally: `npm install -g @respira/wordpress-mcp-server` then use `{
 
 </details>
 
+<details>
+<summary><b>"HTML instead of JSON" / homepage redirect on every tool call</b></summary>
+
+Some WordPress sites have plugin or theme rewrite rules that catch `/wp-json/[anything]` and rewrite the path to `index.php` *without* the `?rest_route=` query var. The result: WordPress's `redirect_canonical()` 301-redirects the request to the homepage (you'll see `x-redirect-by: WordPress` on the redirect chain), and the MCP server gets HTML back where it expected JSON.
+
+Since v6.11.2, the MCP server **auto-detects this and transparently retries the call as `?rest_route=...` against the site root**. If the retry returns JSON, it sets a per-session sticky flag and routes every subsequent call directly through `?rest_route=`, with one stderr warning on first activation.
+
+For sites where you know this rewrite shadowing is in play, you can skip the pretty-permalink probe entirely by adding `forceRestRoute: true` to the site config:
+
+```json
+{
+  "sites": [
+    {
+      "id": "my-site",
+      "name": "My WordPress Site",
+      "url": "https://yoursite.com",
+      "apiKey": "respira_your-api-key",
+      "default": true,
+      "forceRestRoute": true
+    }
+  ]
+}
+```
+
+Run `wordpress_diagnose_connection` for triangulation — it now probes both the pretty path and the `?rest_route=` form, and reports `rest_route_fallback_worked`, `rest_route_fallback_active`, and `force_rest_route_configured`.
+
+</details>
+
 <details>
 <summary><b>Tools not showing</b></summary>
 

package/dist/__tests__/rest-route-fallback.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Tests for the v6.11.2 `?rest_route=` auto-fallback that engages when a
+ * WordPress site has plugin/theme rewrite rules shadowing `/wp-json/[anything]`
+ * and triggering `redirect_canonical()` (homepage 301 with header
+ * `x-redirect-by: WordPress`).
+ *
+ * Mocks `axios.defaults.adapter` so both the per-instance clients AND the
+ * inline `axios.request()` call inside `retryViaRestRoute` go through the
+ * same fake. This works because dispatchRequest.js resolves the adapter as
+ * `config.adapter || defaults.adapter` per request — instances don't snapshot
+ * defaults at creation time.
+ */
+export {};
+//# sourceMappingURL=rest-route-fallback.test.d.ts.map

package/dist/__tests__/rest-route-fallback.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest-route-fallback.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/rest-route-fallback.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/__tests__/rest-route-fallback.test.js

@@ -0,0 +1,265 @@
+/**
+ * Tests for the v6.11.2 `?rest_route=` auto-fallback that engages when a
+ * WordPress site has plugin/theme rewrite rules shadowing `/wp-json/[anything]`
+ * and triggering `redirect_canonical()` (homepage 301 with header
+ * `x-redirect-by: WordPress`).
+ *
+ * Mocks `axios.defaults.adapter` so both the per-instance clients AND the
+ * inline `axios.request()` call inside `retryViaRestRoute` go through the
+ * same fake. This works because dispatchRequest.js resolves the adapter as
+ * `config.adapter || defaults.adapter` per request — instances don't snapshot
+ * defaults at creation time.
+ */
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import axios from 'axios';
+import { WordPressClient } from '../wordpress-client.js';
+const callLog = [];
+let currentHandler = null;
+const originalAdapter = axios.defaults.adapter;
+function installMockAdapter() {
+    callLog.length = 0;
+    axios.defaults.adapter = ((config) => {
+        callLog.push({
+            method: (config.method || 'get').toLowerCase(),
+            url: config.url,
+            baseURL: config.baseURL,
+            params: config.params,
+        });
+        if (!currentHandler) {
+            return Promise.reject(new Error('no mock handler installed'));
+        }
+        const result = currentHandler(config);
+        return Promise.resolve(result).then((r) => ({
+            status: r.status,
+            statusText: 'OK',
+            headers: r.headers || {},
+            config,
+            data: r.data,
+            request: {},
+        }));
+    });
+}
+function restoreAdapter() {
+    axios.defaults.adapter = originalAdapter;
+    currentHandler = null;
+}
+function setHandler(h) {
+    currentHandler = h;
+}
+function buildConfig(extras = {}) {
+    return {
+        id: 'test-site',
+        name: 'Test Site',
+        url: 'https://example.com',
+        apiKey: 'respira_test_key',
+        ...extras,
+    };
+}
+// HTML body that mimics a WordPress homepage redirect from `redirect_canonical()`.
+const HOMEPAGE_HTML = '<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>Climate Solutions News</title></head><body><h1>Welcome</h1></body></html>';
+// -----------------------------------------------------------------------------
+// Tests
+// -----------------------------------------------------------------------------
+test('rest_route fallback: pretty path returns HTML, fallback returns JSON, caller sees JSON transparently', async () => {
+    installMockAdapter();
+    try {
+        const client = new WordPressClient(buildConfig());
+        setHandler((config) => {
+            const url = config.url || '';
+            const baseURL = config.baseURL || '';
+            const fullUrl = url.startsWith('http') ? url : `${baseURL}${url}`;
+            if (/[?&]rest_route=/.test(fullUrl)) {
+                // Fallback succeeds with proper JSON.
+                return {
+                    status: 200,
+                    headers: { 'content-type': 'application/json' },
+                    data: { pages: [{ id: 1, title: 'Home' }], total: 1, totalPages: 1 },
+                };
+            }
+            // Pretty path returns HTML.
+            return {
+                status: 200,
+                headers: { 'content-type': 'text/html; charset=UTF-8' },
+                data: HOMEPAGE_HTML,
+            };
+        });
+        const pages = await client.listPages({ perPage: 50 });
+        assert.deepEqual(pages, { pages: [{ id: 1, title: 'Home' }], total: 1, totalPages: 1 });
+        // Three adapter calls expected:
+        //   1. v2 negotiation probe to /wp-json/respira/v2/status → HTML
+        //   2. Auto-fallback to /?rest_route=/respira/v2/status → JSON (sticky flag trips)
+        //   3. listPages — interceptor rewrites directly to ?rest_route= → JSON
+        assert.equal(callLog.length, 3, `expected 3 adapter calls, got ${callLog.length}`);
+        // First call is the pretty path (against the v2 status endpoint).
+        const firstFullUrl = callLog[0].url.startsWith('http')
+            ? callLog[0].url
+            : `${callLog[0].baseURL || ''}${callLog[0].url}`;
+        assert.match(firstFullUrl, /\/wp-json\/respira\//, 'first call should be a pretty /wp-json/respira/ URL');
+        // The fallback retry was issued.
+        assert.ok(callLog.some((c) => /[?&]rest_route=/.test(c.url)), 'expected at least one ?rest_route= adapter call');
+        // No call should hit the pretty `/wp-json/respira/.../pages` path after the sticky flag tripped.
+        const callsAfterFallback = callLog.slice(2);
+        for (const c of callsAfterFallback) {
+            const full = c.url.startsWith('http') ? c.url : `${c.baseURL || ''}${c.url}`;
+            assert.match(full, /[?&]rest_route=/, `post-sticky call should be in rest_route form, got: ${full}`);
+        }
+        // Sticky flag should be on after a successful fallback.
+        assert.equal(client.useRestRouteFallback, true);
+    }
+    finally {
+        restoreAdapter();
+    }
+});
+test('rest_route fallback: HTML on both paths — error surfaces with both URLs', async () => {
+    installMockAdapter();
+    try {
+        const client = new WordPressClient(buildConfig());
+        setHandler(() => ({
+            status: 200,
+            headers: { 'content-type': 'text/html; charset=UTF-8' },
+            data: HOMEPAGE_HTML,
+        }));
+        let caught = null;
+        try {
+            await client.listPages();
+        }
+        catch (err) {
+            caught = err;
+        }
+        assert.ok(caught, 'expected listPages to throw when both pretty and rest_route return HTML');
+        assert.equal(caught.code, 'respira_html_instead_of_json');
+        assert.match(caught.message, /HTML instead of JSON/);
+        // Original pretty URL is in the error.
+        assert.ok(typeof caught.url === 'string' && caught.url.includes('/wp-json/'));
+        // Fallback URL is also surfaced.
+        assert.ok(typeof caught.fallbackUrl === 'string' && /rest_route=/.test(caught.fallbackUrl));
+        // Sticky flag stays off — fallback didn't succeed.
+        assert.equal(client.useRestRouteFallback, false);
+    }
+    finally {
+        restoreAdapter();
+    }
+});
+test('rest_route fallback: sticky flag — second call goes directly to ?rest_route=', async () => {
+    installMockAdapter();
+    try {
+        const client = new WordPressClient(buildConfig());
+        setHandler((config) => {
+            const url = config.url || '';
+            const baseURL = config.baseURL || '';
+            const fullUrl = url.startsWith('http') ? url : `${baseURL}${url}`;
+            if (/[?&]rest_route=/.test(fullUrl)) {
+                return {
+                    status: 200,
+                    headers: { 'content-type': 'application/json' },
+                    data: { pages: [], total: 0, totalPages: 0 },
+                };
+            }
+            return {
+                status: 200,
+                headers: { 'content-type': 'text/html; charset=UTF-8' },
+                data: HOMEPAGE_HTML,
+            };
+        });
+        // First call: pretty path → HTML → fallback → JSON. Two adapter calls.
+        await client.listPages();
+        const callsAfterFirst = callLog.length;
+        assert.equal(client.useRestRouteFallback, true);
+        // Second call: should go directly to ?rest_route= — exactly one more adapter call.
+        await client.listPages();
+        const newCalls = callLog.slice(callsAfterFirst);
+        assert.equal(newCalls.length, 1, 'sticky flag should make the second call hit only one URL');
+        assert.match(newCalls[0].url, /[?&]rest_route=/, 'second call should be in rest_route form');
+    }
+    finally {
+        restoreAdapter();
+    }
+});
+test('forceRestRoute=true skips the pretty-permalink probe entirely', async () => {
+    installMockAdapter();
+    try {
+        const client = new WordPressClient(buildConfig({ forceRestRoute: true }));
+        setHandler((config) => {
+            const url = config.url || '';
+            const baseURL = config.baseURL || '';
+            const fullUrl = url.startsWith('http') ? url : `${baseURL}${url}`;
+            if (/[?&]rest_route=/.test(fullUrl)) {
+                return {
+                    status: 200,
+                    headers: { 'content-type': 'application/json' },
+                    data: { pages: [{ id: 7 }], total: 1, totalPages: 1 },
+                };
+            }
+            // If anyone hits the pretty path while forceRestRoute is on, fail loud.
+            throw new Error(`pretty path was hit despite forceRestRoute=true: ${fullUrl}`);
+        });
+        assert.equal(client.useRestRouteFallback, true, 'sticky flag should be primed from forceRestRoute');
+        const pages = await client.listPages();
+        assert.deepEqual(pages, { pages: [{ id: 7 }], total: 1, totalPages: 1 });
+        // Every adapter call should be in rest_route form.
+        for (const c of callLog) {
+            assert.match(c.url, /[?&]rest_route=/, `expected rest_route form, got ${c.url}`);
+        }
+    }
+    finally {
+        restoreAdapter();
+    }
+});
+test('diagnose_connection reports rest_route_fallback_worked: true when applicable', async () => {
+    installMockAdapter();
+    try {
+        const client = new WordPressClient(buildConfig());
+        setHandler((config) => {
+            const url = config.url || '';
+            const baseURL = config.baseURL || '';
+            const fullUrl = url.startsWith('http') ? url : `${baseURL}${url}`;
+            // /wp-json/ root: returns the route listing JSON cleanly.
+            if (/\/wp-json\/?$/.test(fullUrl) || fullUrl.endsWith('/wp-json/')) {
+                return {
+                    status: 200,
+                    headers: { 'content-type': 'application/json' },
+                    data: { namespaces: ['respira/v1'] },
+                };
+            }
+            // ?rest_route= form: returns JSON.
+            if (/[?&]rest_route=/.test(fullUrl)) {
+                return {
+                    status: 200,
+                    headers: { 'content-type': 'application/json' },
+                    data: { ok: true, pong: true },
+                };
+            }
+            // Pretty respira path: returns HTML (homepage redirect).
+            if (/\/wp-json\/respira\//.test(fullUrl)) {
+                return {
+                    status: 200,
+                    headers: { 'content-type': 'text/html; charset=UTF-8' },
+                    data: HOMEPAGE_HTML,
+                };
+            }
+            return {
+                status: 404,
+                headers: { 'content-type': 'application/json' },
+                data: { code: 'rest_no_route' },
+            };
+        });
+        const report = await client.diagnoseConnection({});
+        assert.equal(report.success, true);
+        assert.equal(report.rest_route_fallback_worked, true);
+        assert.equal(report.html_instead_of_json, true);
+        // The pretty respira_ping probe should be HTML, the rest_route ping should be JSON.
+        const pretty = report.outside_probes.find((p) => p.label === 'respira_ping');
+        const restRoute = report.outside_probes.find((p) => p.label === 'respira_ping_rest_route');
+        assert.ok(pretty, 'expected respira_ping probe in report');
+        assert.ok(restRoute, 'expected respira_ping_rest_route probe in report');
+        assert.equal(pretty.looks_like_html, true);
+        assert.equal(restRoute.looks_like_html, false);
+        // Recommendation about rewrite shadowing.
+        assert.ok(report.recommendations.some((r) => /rest_route/i.test(r) && /shadow/i.test(r)), 'expected a recommendation mentioning rest_route + shadowing');
+    }
+    finally {
+        restoreAdapter();
+    }
+});
+//# sourceMappingURL=rest-route-fallback.test.js.map

package/dist/__tests__/rest-route-fallback.test.js.map

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

package/dist/server.d.ts

@@ -60,6 +60,26 @@ export declare class RespiraWordPressServer {
      */
     private isAcfAvailable;
     private getWooCommerceTools;
+    /**
+     * camelCase → snake_case rename map (mcp-v6.11.1).
+     *
+     * Schemas advertise snake_case only. Handlers can read either form for one
+     * release; camelCase emits a deprecation warning to stderr and will be
+     * removed in mcp-v6.13.
+     *
+     * Mirrors both directions so wordpress-client.ts (which still reads
+     * camelCase fields like data.customCss / data.featuredMedia / args.edit_target
+     * before mapping them to plugin-side snake_case) keeps working unchanged.
+     * The wordpress-client surface is purely internal — its rename can ride
+     * along in a follow-up release without breaking callers.
+     */
+    private static readonly CAMEL_TO_SNAKE_PARAMS;
+    /**
+     * Normalize tool args so handlers see both snake_case (new, advertised in
+     * the schema) and camelCase (legacy, kept working for one release with a
+     * deprecation warning). Mutates the args object in place and returns it.
+     */
+    private normalizeArgsForBackCompat;
     private handleToolCall;
     private dispatchToolCall;
     /**

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;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;IAyPvE,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;IAmjEtB;;;;;;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;IAqkB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+QzB;;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,CAAY;IAEtD;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IAyPvE,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;IAmjEtB;;;;;;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;IAwT3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;YA0Bd,gBAAgB;IAqkB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA+QzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAKV"}