@respira/wordpress-mcp-server 8.2.6 → 8.2.8

package/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to Respira WordPress MCP Server will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.2.8] - 2026-08-11
+
+### Fixed
+
+- **`apply_builder_patch` and `update_element`'s `unset` operation had no valid shape a strict client could use.** The write-path handling for removing a stale attribute alias (e.g. a Divi 5 button's leftover `content` key) was already correct; the served tool schema for `operations`/`updates` never documented `unset` as a real property, so a client validating against the schema had nowhere to put it. Both tool definitions now declare it, matching the plugin's REST route and native ability registry, which already did.
+
+## [8.2.7] - 2026-08-10
+
+### Fixed
+
+- **A host briefly refusing one request read as "your site is down".** When a server in front of WordPress returned a 5xx, the message said the site might be down, misconfigured or behind a failing proxy, and told you to check that it loads in a browser. On a site that is up and serving hundreds of other calls that is a wild goose chase, and it is the one people take: a customer was told a firewall was blocking Respira when his host had shed six requests out of roughly a thousand, in two short bursts, all during heavy page building. 503 and 504 now read as what they are, a host declining a single request, usually the account's cap on simultaneous PHP processes, with the advice that helps: wait a few seconds, retry, and space out large builder writes. The message also now says that because the response came from in front of WordPress, WordPress never ran and nothing was written, so the call is safe to repeat.
+
+### Added
+
+- Three Figma conversion skills: figma-to-divi, figma-to-bricks and figma-to-gutenberg.
+
 ## [8.2.6] - 2026-08-10
 
 ### Fixed

package/dist/__tests__/transient-5xx-guidance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transient-5xx-guidance.test.d.ts.map

package/dist/__tests__/transient-5xx-guidance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-5xx-guidance.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/transient-5xx-guidance.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/transient-5xx-guidance.test.js

@@ -0,0 +1,48 @@
+import { test } from 'node:test';
+import assert from 'node:assert';
+import { isReplaySafeRetry } from '../wordpress-client.js';
+// A customer was told a firewall was blocking Respira. It was not. His host had
+// shed six requests out of roughly a thousand, in two short bursts, every one of
+// them a heavy builder write, while the site served everything else normally.
+//
+// Two things produced that wrong diagnosis, and both are ours:
+//
+//   1. the message for a non-WordPress 5xx said "the site may be down ... check
+//      that the site loads normally in a browser", which is a wild goose chase
+//      on a site that is up;
+//   2. the write never retried, because writes only retry when the response
+//      advertises idempotency support and no plugin build has ever sent that
+//      header. See the note on the retry test below.
+test('a read retries on any 5xx', () => {
+    for (const status of [500, 502, 503, 504]) {
+        assert.equal(isReplaySafeRetry({ method: 'GET', status }), true, `GET ${status}`);
+    }
+});
+test('a write does NOT retry on a 5xx unless the site advertises idempotency', () => {
+    // This is correct in isolation: replaying a write whose commit state is
+    // unknown can apply an edit twice.
+    for (const status of [502, 503, 504]) {
+        assert.equal(isReplaySafeRetry({ method: 'POST', status }), false, `POST ${status} must not blind-retry`);
+        assert.equal(isReplaySafeRetry({ method: 'POST', status, idempotencySupported: true }), true, `POST ${status} may retry when the site advertises replay safety`);
+    }
+});
+test('a write does not retry on a 500, even with idempotency support', () => {
+    // 500 means WordPress ran and failed. Repeating it fails again more slowly.
+    assert.equal(isReplaySafeRetry({ method: 'POST', status: 500, idempotencySupported: true }), false);
+});
+// KNOWN GAP, deliberately recorded rather than asserted away.
+//
+// `idempotencySupported` is read from the `x-respira-idempotency-supported`
+// response header. No plugin build has ever sent that header: the replay
+// machinery (write receipts, stable call_id, idempotent_replay) lives on the
+// native/streamable transport, not the REST path this client uses. So the
+// branch above is unreachable in production and every npm-connected write dies
+// on the first transient 5xx.
+//
+// Closing it means the plugin advertising the header AND deduplicating a
+// replayed call_id on the REST write path. Until then the client compensates by
+// telling the agent the write did not commit, so it can retry deliberately.
+test('the retry branch that never fires is still specified, so closing the gap has a target', () => {
+    assert.equal(isReplaySafeRetry({ method: 'POST', status: 503, idempotencySupported: true }), true, 'when the plugin starts advertising idempotency, writes must retry on 503');
+});
+//# sourceMappingURL=transient-5xx-guidance.test.js.map

package/dist/__tests__/transient-5xx-guidance.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transient-5xx-guidance.test.js","sourceRoot":"","sources":["../../src/__tests__/transient-5xx-guidance.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,gFAAgF;AAChF,iFAAiF;AACjF,8EAA8E;AAC9E,EAAE;AACF,+DAA+D;AAC/D,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,6BAA6B;AAC7B,4EAA4E;AAC5E,6EAA6E;AAC7E,qDAAqD;AAErD,IAAI,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACrC,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,MAAM,EAAE,CAAC,CAAC;IACpF,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;IAClF,wEAAwE;IACxE,mCAAmC;IACnC,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,KAAK,CACV,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAC7C,KAAK,EACL,QAAQ,MAAM,uBAAuB,CACtC,CAAC;QACF,MAAM,CAAC,KAAK,CACV,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,EACzE,IAAI,EACJ,QAAQ,MAAM,mDAAmD,CAClE,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC1E,4EAA4E;IAC5E,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AACtG,CAAC,CAAC,CAAC;AAEH,8DAA8D;AAC9D,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,6EAA6E;AAC7E,0EAA0E;AAC1E,+EAA+E;AAC/E,8BAA8B;AAC9B,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,4EAA4E;AAC5E,IAAI,CAAC,uFAAuF,EAAE,GAAG,EAAE;IACjG,MAAM,CAAC,KAAK,CACV,iBAAiB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,CAAC,EAC9E,IAAI,EACJ,0EAA0E,CAC3E,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAsHzE;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAoBhF;AAiID,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;IACpC,iFAAiF;IACjF,OAAO,CAAC,iBAAiB,CAAK;IAC9B,iFAAiF;IACjF,OAAO,CAAC,mBAAmB,CAAgC;IAE3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEhE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IA6VvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA4BrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IA2CxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IA4OhC;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAgE7B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;YACW,qBAAqB;YAiBrB,kBAAkB;IA6FhC,yFAAyF;IACzF,OAAO,CAAC,gBAAgB;IASxB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAmQP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IA02GtB;;;;;;OAMG;IACH;;;;;;;;;;;;;oDAagD;IAChD,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IAC1D;;mDAE+C;IAC/C,OAAO,CAAC,0BAA0B,CAAoC;IAEtE;;;;;;;;OAQG;YACW,0BAA0B;YAyC1B,oBAAoB;YA6CpB,2BAA2B;IAQzC;;;;OAIG;YACW,cAAc;IAQ5B,OAAO,CAAC,mBAAmB;IAw9C3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IA4G5B,oEAAoE;IACpE,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IAk4C9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkZzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CA+CV"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAsHzE;;;;;;;;;;;;;;;;GAgBG;AACH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,GAAG,MAAM,CAoBhF;AAiID,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;IACpC,iFAAiF;IACjF,OAAO,CAAC,iBAAiB,CAAK;IAC9B,iFAAiF;IACjF,OAAO,CAAC,mBAAmB,CAAgC;IAE3D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAsB;IAEhE;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;gBA4Bb,WAAW,EAAE,mBAAmB,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE;IA6VvE,OAAO,CAAC,cAAc;IAItB;;;;;;;;;OASG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,aAAa;IA4BrB,gEAAgE;IAChE,OAAO,CAAC,aAAa;IAUrB;;;;;;OAMG;YACW,UAAU;IA2CxB;;;;;;;;;;;;;;OAcG;YACW,WAAW;IAiJzB;;;;;;;;;OASG;YACW,kBAAkB;IA4OhC;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAgE7B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;YACW,qBAAqB;YAiBrB,kBAAkB;IA6FhC,yFAAyF;IACzF,OAAO,CAAC,gBAAgB;IASxB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,6BAA6B;IA0BrC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,yBAAyB;IA+BjC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,aAAa;YAmQP,kBAAkB;YA6BlB,yBAAyB;IASvC;;;OAGG;IACH,OAAO,CAAC,oBAAoB;YAyBd,QAAQ;IAi3GtB;;;;;;OAMG;IACH;;;;;;;;;;;;;oDAagD;IAChD,OAAO,CAAC,mBAAmB,CAAoD;IAC/E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAU;IAClD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IAC1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAS;IAC1D;;mDAE+C;IAC/C,OAAO,CAAC,0BAA0B,CAAoC;IAEtE;;;;;;;;OAQG;YACW,0BAA0B;YAyC1B,oBAAoB;YA6CpB,2BAA2B;IAQzC;;;;OAIG;YACW,cAAc;IAQ5B,OAAO,CAAC,mBAAmB;IAw9C3B;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAe3C;IAEF;;;;OAIG;IACH,OAAO,CAAC,0BAA0B;YAmCpB,cAAc;IA4G5B,oEAAoE;IACpE,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,eAAe;YAuCT,gBAAgB;IAk4C9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0ZzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CA+CV"}

package/dist/server.js

@@ -3185,7 +3185,14 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                                     },
                                     updates: {
                                         type: 'object',
-                                        description: 'Patch to merge into the matched element. Same shape as wordpress_update_module.updates: { content?: string, attributes?: object, ...flat_settings_keys? }. Flat keys (admin_label, background_color, font_size, ...) route through the adapter\'s deep-set helper.',
+                                        description: 'Patch to merge into the matched element. Same shape as wordpress_update_module.updates: { content?: string, attributes?: object, unset?: string[], ...flat_settings_keys? }. Flat keys (admin_label, background_color, font_size, ...) route through the adapter\'s deep-set helper. `unset` is a STRUCTURED array of attribute key names to remove (e.g. ["content"] drops a stale content alias attribute so the module\'s real content attribute takes precedence) — never a single string, and never merged in as literal data.',
+                                        properties: {
+                                            unset: {
+                                                type: 'array',
+                                                items: { type: 'string' },
+                                                description: 'Attribute key names to remove from the matched element (e.g. a stale content alias). A single string is also accepted and treated as a one-element list.',
+                                            },
+                                        },
                                     },
                                 },
                             },
@@ -8200,7 +8207,14 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                         identifier_value: { type: 'string', description: 'Value to match' },
                         updates: {
                             type: 'object',
-                            description: 'Key-value pairs of settings to update on the matched element. Do NOT put `edit_target` or `confirm_live_edit` in this object; pass them as top-level params (otherwise they get persisted as element settings).',
+                            description: 'Key-value pairs of settings to update on the matched element. Do NOT put `edit_target` or `confirm_live_edit` in this object; pass them as top-level params (otherwise they get persisted as element settings). `unset` is a STRUCTURED array of attribute key names to remove (e.g. ["content"] drops a stale content alias attribute so a different one takes precedence) — never a single string, and never treated as a value to write.',
+                            properties: {
+                                unset: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    description: 'Attribute key names to remove from the matched element. A single string is also accepted and treated as a one-element list.',
+                                },
+                            },
                         },
                         edit_target: {
                             type: 'string',