@respira/wordpress-mcp-server 8.3.22 → 8.3.23

package/CHANGELOG.md

@@ -5,6 +5,16 @@ 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.3.23] - 2026-09-11
+
+### Fixed
+
+- **`apply_builder_patch` accepts `find_element`'s identifier shapes.** The tool now
+  documents and accepts `{ type: "id" | "path" | "admin_label", value }` and
+  `{ identifier_type, identifier_value }` next to the existing `{ id | path | admin_label |
+  type }`, and rewrites them before sending, so they also work against older plugins for
+  path, admin_label and module type. Resolving a Divi 5 element id needs plugin 8.8.35.
+
 ## [8.3.22] - 2026-09-11
 
 Writes that reach the site, or say plainly why they did not.

package/dist/__tests__/9dee06c4-patch-identifier-vocabulary.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=9dee06c4-patch-identifier-vocabulary.test.d.ts.map

package/dist/__tests__/9dee06c4-patch-identifier-vocabulary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"9dee06c4-patch-identifier-vocabulary.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/9dee06c4-patch-identifier-vocabulary.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/9dee06c4-patch-identifier-vocabulary.test.js

@@ -0,0 +1,130 @@
+/**
+ * Ticket 9dee06c4 (Nathan, n2workspaces.com, Divi 5.10.1, plugin 8.8.20):
+ * "apply-builder-patch cannot resolve that target by {"type":"id"} or
+ * {"type":"path"} (respira_patch_target_not_found) while find-element
+ * resolves both."
+ *
+ * respira_find_element takes identifier_type + identifier_value. A patch
+ * identifier is an object keyed by what you know ({ id }, { path }), where
+ * `type` means the MODULE type. The agent carried find_element's words over
+ * and sent { type: "id", value: "..." }, so the plugin searched for a module of
+ * type "id" and found none.
+ *
+ * Two things are checked here, both the way a client meets them:
+ *   1. The published tool schema states the accepted shapes: `type` is the
+ *      module type, and find_element's vocabulary (`value`, `identifier_type`,
+ *      `identifier_value`) is listed and described.
+ *   2. The real WordPressClient sends that vocabulary in the canonical shape,
+ *      so it resolves even on a plugin that predates the plugin-side fix. What
+ *      it must NOT touch is checked too: a real module type, a value-less
+ *      identifier, and a conflict are forwarded exactly as sent.
+ */
+import assert from 'node:assert/strict';
+import { test, after } from 'node:test';
+import { resolve } from 'node:path';
+import http from 'node:http';
+import { Client } from '@modelcontextprotocol/client';
+import { StdioClientTransport } from '@modelcontextprotocol/client/stdio';
+import { WordPressClient } from '../wordpress-client.js';
+const servers = [];
+after(() => {
+    for (const server of servers)
+        server.close();
+});
+async function listen(handler) {
+    const server = http.createServer(handler);
+    servers.push(server);
+    await new Promise((resolveListen) => server.listen(0, '127.0.0.1', resolveListen));
+    return server.address().port;
+}
+test('9dee06c4: the published apply_builder_patch schema states the accepted identifier shapes', { timeout: 20_000 }, async () => {
+    const port = await listen((_request, response) => {
+        response.writeHead(200, { 'content-type': 'application/json' });
+        response.end(JSON.stringify({ wordpress_version: '6.8', page_builder: { name: 'divi', version: '5.10.1' }, active_plugins: [] }));
+    });
+    const config = Buffer.from(JSON.stringify({
+        sites: [{ id: 'patch-ident', name: 'Patch identifier', url: `http://127.0.0.1:${port}`, apiKey: 'respira_patch_ident', default: true }],
+        preferences: { autoDuplicate: true, securityChecks: true },
+    })).toString('base64');
+    const client = new Client({ name: 'respira-9dee06c4', version: '1.0.0' });
+    try {
+        await client.connect(new StdioClientTransport({
+            command: process.execPath,
+            args: [resolve(process.cwd(), 'dist/index.js')],
+            cwd: process.cwd(),
+            stderr: 'pipe',
+            env: { ...process.env, RESPIRA_CONFIG_B64: config, RESPIRA_USAGE_OPT_OUT: '1', NODE_ENV: 'test' },
+        }));
+        const { tools } = await client.listTools();
+        const tool = tools.find((candidate) => /(^|_)apply_builder_patch$/.test(candidate.name));
+        assert.ok(tool, 'apply_builder_patch must be published');
+        const identifier = tool.inputSchema.properties?.operations?.items?.properties?.identifier;
+        assert.equal(identifier?.type, 'object', 'operations[].identifier must be an object');
+        const properties = identifier.properties ?? {};
+        for (const canonical of ['id', 'path', 'admin_label', 'type', 'match_content']) {
+            assert.ok(properties[canonical], `identifier.${canonical} must still be published`);
+        }
+        for (const alias of ['value', 'identifier_type', 'identifier_value']) {
+            assert.equal(properties[alias]?.type, 'string', `identifier.${alias} (find_element vocabulary) must be published as a string`);
+            assert.ok(String(properties[alias]?.description ?? '').length > 0, `identifier.${alias} must say what it is for`);
+        }
+        assert.match(String(identifier.description), /MODULE type/, 'the identifier description must say `type` is the module type');
+        assert.match(String(identifier.description), /identifier_type/, 'the identifier description must name find_element\'s vocabulary');
+        assert.match(String(tool.description), /\{ type: "id", value: "\.\.\." \}/, 'the tool description must show the find_element shape it accepts');
+        assert.match(String(tool.description), /respira_patch_ambiguous_target/, 'the tool description must say a shared id is refused');
+    }
+    finally {
+        await client.close();
+    }
+});
+test('9dee06c4: the client sends find_element vocabulary in the canonical identifier shape', async () => {
+    const bodies = [];
+    const port = await listen((request, response) => {
+        const url = request.url ?? '';
+        if (request.method === 'GET' && url.startsWith('/wp-json/respira/v2/status')) {
+            response.writeHead(200, { 'content-type': 'application/json' });
+            response.end(JSON.stringify({ ok: true }));
+            return;
+        }
+        if (request.method === 'POST' && url.startsWith('/wp-json/respira/v2/builder/divi/patch/42')) {
+            let raw = '';
+            request.on('data', (chunk) => { raw += chunk; });
+            request.on('end', () => {
+                bodies.push(JSON.parse(raw));
+                response.writeHead(200, { 'content-type': 'application/json' });
+                response.end(JSON.stringify({ success: true }));
+            });
+            return;
+        }
+        response.writeHead(404, { 'content-type': 'application/json' });
+        response.end(JSON.stringify({ code: 'not_found' }));
+    });
+    const wp = new WordPressClient({
+        id: 'patch-ident',
+        name: 'patch-ident',
+        url: `http://127.0.0.1:${port}`,
+        apiKey: 'respira_test_key',
+    });
+    const update = { content: '<p>New</p>' };
+    await wp.applyBuilderPatch('divi', 42, [
+        { identifier: { type: 'id', value: '2c3a794b-0000-4000-8000-000000000001' }, updates: update },
+        { identifier: { type: 'path', value: '0.2.1.0.1.3' }, updates: update },
+        { identifier: { identifier_type: 'admin_label', identifier_value: 'Hero' }, updates: update },
+        { identifier: { identifier_type: 'type', identifier_value: 'divi/text', match_content: 'Why us' }, updates: update },
+        // Must reach the plugin exactly as sent.
+        { identifier: { type: 'divi/text', match_content: 'Why us' }, updates: update },
+        { identifier: { type: 'id' }, updates: update },
+        { identifier: { type: 'id', value: 'aaa', id: 'bbb' }, updates: update },
+    ]);
+    assert.equal(bodies.length, 1, 'exactly one patch request is sent');
+    const identifiers = bodies[0].operations.map((operation) => operation.identifier);
+    assert.deepEqual(identifiers[0], { id: '2c3a794b-0000-4000-8000-000000000001' }, '{ type: "id", value } is sent as { id }');
+    assert.deepEqual(identifiers[1], { path: '0.2.1.0.1.3' }, '{ type: "path", value } is sent as { path }');
+    assert.deepEqual(identifiers[2], { admin_label: 'Hero' }, '{ identifier_type, identifier_value } is sent as the canonical key');
+    assert.deepEqual(identifiers[3], { type: 'divi/text', match_content: 'Why us' }, 'identifier_type "type" becomes the module type and keeps match_content');
+    assert.deepEqual(identifiers[4], { type: 'divi/text', match_content: 'Why us' }, 'a real module type is untouched');
+    assert.deepEqual(identifiers[5], { type: 'id' }, 'an identifier with no value is untouched (the plugin explains the shape)');
+    assert.deepEqual(identifiers[6], { type: 'id', value: 'aaa', id: 'bbb' }, 'a conflicting identifier is untouched (the plugin refuses it)');
+    assert.deepEqual(bodies[0].operations[0].updates, update, 'updates are forwarded unchanged');
+});
+//# sourceMappingURL=9dee06c4-patch-identifier-vocabulary.test.js.map

package/dist/__tests__/9dee06c4-patch-identifier-vocabulary.test.js.map

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

package/dist/patch-identifier.d.ts

@@ -0,0 +1,5 @@
+/** Rewrite one patch identifier from find_element's vocabulary to the canonical key. */
+export declare function normalizePatchIdentifier(identifier: unknown): unknown;
+/** Apply normalizePatchIdentifier to every operation's identifier. */
+export declare function normalizePatchOperations<T>(operations: T): T;
+//# sourceMappingURL=patch-identifier.d.ts.map

package/dist/patch-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-identifier.d.ts","sourceRoot":"","sources":["../src/patch-identifier.ts"],"names":[],"mappings":"AAoCA,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,OAAO,GAAG,OAAO,CAyCrE;AAED,sEAAsE;AACtE,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAU5D"}

package/dist/patch-identifier.js

@@ -0,0 +1,87 @@
+/**
+ * Ticket 9dee06c4 (Divi 5.10.1): an agent that had just resolved an element
+ * with respira_find_element (`identifier_type` + `identifier_value`) carried
+ * those words into respira_apply_builder_patch and sent
+ * `{ type: "id", value: "2c3a794b-..." }` and `{ type: "path", value: "0.2.1.0.1.3" }`.
+ * In a patch identifier `type` is the MODULE type, so the plugin searched for a
+ * module of type "id" and answered respira_patch_target_not_found.
+ *
+ * The plugin now reads that vocabulary itself (Respira_Builder_Patcher::
+ * normalize_identifier). This does the same rewrite before the request leaves,
+ * so the shapes the tool schema advertises also work against plugin versions
+ * that predate the fix. Keep the word list in step with
+ * Respira_Builder_Patcher::FIND_ELEMENT_IDENTIFIER_TYPES.
+ *
+ * Deliberately conservative: an identifier is only rewritten when the value is
+ * present and the canonical key is not already set. Anything else is sent as
+ * is, and the plugin decides (including refusing a conflict).
+ */
+const FIND_ELEMENT_IDENTIFIER_TYPES = {
+    id: 'id',
+    path: 'path',
+    admin_label: 'admin_label',
+    type: 'type',
+    widget_type: 'type',
+    class: 'class',
+    content: 'content',
+    text: 'text',
+    uncode_shortcode_id: 'uncode_shortcode_id',
+};
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/** Rewrite one patch identifier from find_element's vocabulary to the canonical key. */
+export function normalizePatchIdentifier(identifier) {
+    if (!isPlainObject(identifier)) {
+        return identifier;
+    }
+    let word;
+    let value;
+    let drop;
+    if (typeof identifier.identifier_type === 'string' && 'identifier_value' in identifier) {
+        word = identifier.identifier_type;
+        value = identifier.identifier_value;
+        drop = ['identifier_type', 'identifier_value'];
+    }
+    else if (typeof identifier.type === 'string' && 'value' in identifier) {
+        word = identifier.type;
+        value = identifier.value;
+        drop = ['type', 'value'];
+    }
+    else {
+        return identifier;
+    }
+    const key = FIND_ELEMENT_IDENTIFIER_TYPES[String(word).trim().toLowerCase()];
+    if (!key) {
+        return identifier;
+    }
+    if (typeof value !== 'string' && typeof value !== 'number') {
+        return identifier;
+    }
+    const text = String(value).trim();
+    if (text === '') {
+        return identifier;
+    }
+    const out = { ...identifier };
+    for (const name of drop) {
+        delete out[name];
+    }
+    if (key in out) {
+        return identifier;
+    }
+    out[key] = text;
+    return out;
+}
+/** Apply normalizePatchIdentifier to every operation's identifier. */
+export function normalizePatchOperations(operations) {
+    if (!Array.isArray(operations)) {
+        return operations;
+    }
+    return operations.map((operation) => {
+        if (!isPlainObject(operation) || !('identifier' in operation)) {
+            return operation;
+        }
+        return { ...operation, identifier: normalizePatchIdentifier(operation.identifier) };
+    });
+}
+//# sourceMappingURL=patch-identifier.js.map

package/dist/patch-identifier.js.map

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

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -4397,7 +4397,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'wordpress_apply_builder_patch',
-                description: 'Apply a list of targeted builder patch operations. Each operation is { identifier: { id|admin_label|path|type [+match_content] }, updates: { content?, attributes?, ...flat_settings? } }. The identifier block follows the same shape as wordpress_find_element\'s identifier; the updates block follows the same shape as wordpress_update_module\'s updates. Returns 400 respira_patch_invalid_operation when an entry is missing either field. This is NOT a JSON-Patch document — do not pass { op, path, value } shapes (those will be rejected). Example: { operations: [{ identifier: { admin_label: "Hero" }, updates: { admin_label: "Hero Content" } }] }.',
+                description: 'Apply a list of targeted builder patch operations. Each operation is { identifier: { id|admin_label|path|type [+match_content] }, updates: { content?, attributes?, ...flat_settings? } }. The identifier is keyed by what you know: { id: "2c3a794b-..." } (a Divi 5 _nodeId, Elementor or Bricks id), { path: "0.2.1" } (the path_string wordpress_find_element returns), { admin_label: "Hero" }, or { type: "divi/text", match_content: "text inside it" }. In the identifier, `type` is the MODULE type, never the kind of identifier. wordpress_find_element\'s vocabulary is also accepted when the value is present: { identifier_type: "id", identifier_value: "..." } and { type: "id", value: "..." } (type one of id, path, admin_label, class, content, text) are read as { id: "..." }. class, content and text resolve only on Divi 4 shortcode pages; elsewhere they are refused with a 400, so look the element up with wordpress_find_element and send its path_string as { path }. An id shared by several elements (duplicated modules keep their id) is refused with respira_patch_ambiguous_target and the candidate paths. The updates block follows the same shape as wordpress_update_module\'s updates. Returns 400 respira_patch_invalid_operation when an entry is missing either field. This is NOT a JSON-Patch document — do not pass { op, path, value } shapes (those will be rejected). Example: { operations: [{ identifier: { admin_label: "Hero" }, updates: { admin_label: "Hero Content" } }] }.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -4422,13 +4422,16 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                                 properties: {
                                     identifier: {
                                         type: 'object',
-                                        description: 'Element identifier. Provide exactly one of id / admin_label / path / type. match_content disambiguates duplicates of the same type. `path` accepts both dialects: the index form respira_find_element emits ("1.0.1") and the key-interleaved form ("1.children.0.children.1"). They name the same element.',
+                                        description: 'Element identifier. Provide exactly one of id / admin_label / path / type. match_content disambiguates duplicates of the same type. `path` accepts both dialects: the index form respira_find_element emits ("1.0.1") and the key-interleaved form ("1.children.0.children.1"). They name the same element. `type` is the MODULE type ("divi/text"), never the kind of identifier. wordpress_find_element\'s vocabulary is also read: { identifier_type: "id", identifier_value: "..." } or { type: "id", value: "..." } becomes { id: "..." } (type one of id, path, admin_label, class, content, text; value required). Prefer the canonical keys.',
                                         properties: {
-                                            id: { type: 'string', description: 'Builder element ID (Divi 5 _nodeId, Elementor element id, Bricks id, etc).' },
+                                            id: { type: 'string', description: 'Builder element ID (Divi 5 _nodeId, Elementor element id, Bricks id, etc). An id shared by several elements (duplicated modules) is refused with the candidate paths; send one of them as path.' },
                                             admin_label: { type: 'string', description: 'Admin label / navigator label.' },
                                             path: { description: 'Index path as either a dot-string "0.1.2" or an array [0,1,2].' },
-                                            type: { type: 'string', description: 'Module type (e.g. "divi/heading", "et_pb_text", "core/paragraph").' },
+                                            type: { type: 'string', description: 'Module type (e.g. "divi/heading", "et_pb_text", "core/paragraph"). Not the identifier kind: with a `value` next to it, type "id", "path", "admin_label", "class", "content" or "text" is read as find_element vocabulary instead.' },
                                             match_content: { type: 'string', description: 'Optional content substring for disambiguation.' },
+                                            value: { type: 'string', description: 'find_element vocabulary: the value for a `type` of id, path, admin_label, class, content or text. { type: "path", value: "0.2.1" } is read as { path: "0.2.1" }.' },
+                                            identifier_type: { type: 'string', description: 'find_element vocabulary: id, path, admin_label, type, class, content or text. Read together with identifier_value, e.g. { identifier_type: "id", identifier_value: "2c3a794b-..." } is read as { id: "2c3a794b-..." }.' },
+                                            identifier_value: { type: 'string', description: 'find_element vocabulary: the value for identifier_type.' },
                                         },
                                     },
                                     updates: {