@respira/wordpress-mcp-server 7.5.6 → 7.6.1

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAsQzE,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;IAmVvE,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;IAiHhC;;;;;;;;;;;;;;;;;;;;;;;;;;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;IA+vFtB;;;;;;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;IA2uC3B;;;;;;;;;;;;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;IAimC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwUzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAyCV"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAqBH,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,kBAAkB,CAAC;AAsQzE,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;IAiVvE,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;IAiHhC;;;;;;;;;;;;;;;;;;;;;;;;;;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;IAs2FtB;;;;;;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;IA2uC3B;;;;;;;;;;;;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;IA+oC9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAwUzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6UxB,GAAG;CAyCV"}

package/dist/server.js

@@ -428,8 +428,6 @@ Use respira_get_builder_info first to detect which builder is active. Then use t
 - Content format: Array of sections containing columns containing widgets
 - Each widget has a widgetType (e.g. "heading", "text-editor", "image", "button") and settings object
 - Dynamic schemas: Respira reads Elementor's control registry at runtime, so it knows the exact settings, types, and valid values for every widget
-- This includes registered third-party/theme widgets. For an existing custom widget: list_elementor_widgets -> get_elementor_widget_schema -> find_element by content/type -> update_element by the returned stable id with only changed settings -> find_element again to verify
-- Never use extract_builder_content + inject_builder_content or rewrite _elementor_data for a single-widget edit. Widget source code is only a fallback when its rendering semantics are not represented in the registered controls
 - Settings validator catches typos: "Unknown setting 'titel'. Did you mean 'title'?"
 - Responsive: settings support _mobile and _tablet suffixes (e.g. "align" for desktop, "align_mobile" for mobile)
 - respira_find_element works with Elementor widget IDs, types, CSS classes, and text content
@@ -1940,6 +1938,102 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                     required: ['post_id'],
                 },
             },
+            {
+                name: 'wordpress_get_translations',
+                description: 'List every language copy of a page/post in its WPML translation group. Returns each translation with its id, language code, status, title, and url. Call this before create_translation (to see what already exists) or update_translation (to find the translated post id).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'WordPress post/page ID (any language version).' },
+                        type: { type: 'string', description: 'Post type slug: "page" (default), "post", or a CPT.' },
+                    },
+                    required: ['id'],
+                },
+            },
+            {
+                name: 'wordpress_create_translation',
+                description: 'Create a WPML translation of a source page/post in a target language, JOINING the source\'s existing translation group (so WPML treats it as a real translation, not a separate page). Divi and other builder content is carried across into the new copy automatically. Returns 409 if a translation in that language already exists (use update_translation instead). Use respira_get_site_context to confirm WPML is active and see available language codes.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        source_id: { type: 'number', description: 'ID of the source page/post to translate.' },
+                        target_language: { type: 'string', description: 'Target language code, e.g. "de", "nl", "fr".' },
+                        title: { type: 'string', description: 'Optional title for the new translation. Defaults to the source title.' },
+                        type: { type: 'string', description: 'Post type slug: "page" (default), "post", or a CPT.' },
+                    },
+                    required: ['source_id', 'target_language'],
+                },
+            },
+            {
+                name: 'wordpress_update_translation',
+                description: 'Update an existing WPML translation of a source post: set its title and/or raw post_content. Resolves the translated post within the source\'s group and snapshots it before writing. For structured Divi/builder edits to the translated copy, use respira_apply_builder_patch on the returned translation_id instead.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        source_id: { type: 'number', description: 'ID of any page/post in the translation group.' },
+                        target_language: { type: 'string', description: 'Language code of the translation to edit, e.g. "de", "nl".' },
+                        title: { type: 'string', description: 'Optional new title for the translation.' },
+                        content: { type: 'string', description: 'Optional raw post_content for the translation.' },
+                        type: { type: 'string', description: 'Post type slug: "page" (default), "post", or a CPT.' },
+                    },
+                    required: ['source_id', 'target_language'],
+                },
+            },
+            {
+                name: 'wordpress_list_theme_builder_templates',
+                description: 'List the Divi Theme Builder global templates on the site (headers, footers, and body layouts). Each entry carries a layout_id you pass to update_theme_builder_template or apply_builder_patch to edit it, its kind (header/footer/body), name, and where it is assigned. Use this to find a global header before editing it (e.g. to build a mega menu). Works on Divi 4 and Divi 5.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'wordpress_create_theme_builder_template',
+                description: 'Create a Divi global header, footer, or body Theme Builder template, with optional page assignments. Snapshot-protected (reversible within a session). Pass structure as a Divi 4 shortcode string, or a Divi 5 block/node array. Works on Divi 4 and Divi 5.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        kind: { type: 'string', description: 'header, footer, or body.', enum: ['header', 'footer', 'body'] },
+                        name: { type: 'string', description: 'Template name.' },
+                        assignments: {
+                            type: 'object',
+                            description: 'Where it applies. {"all_pages": true} for site-wide, or {"post_types": ["page"], "excluded_ids": [12, 34]}.',
+                        },
+                        structure: { description: 'Divi 4 shortcode string, or a Divi 5 block/node array.' },
+                    },
+                    required: ['kind', 'name'],
+                },
+            },
+            {
+                name: 'wordpress_update_theme_builder_template',
+                description: 'Replace the content of an existing Divi Theme Builder layout (a global header, footer, or body) by its layout_id (from list_theme_builder_templates). Snapshot-protected. For a targeted single-module edit, use apply_builder_patch on the same layout_id instead. Works on Divi 4 and Divi 5.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        layout_id: { type: 'number', description: 'The et_*_layout post id from list_theme_builder_templates.' },
+                        structure: { description: 'Divi 4 shortcode string, or a Divi 5 block/node array (the new content).' },
+                    },
+                    required: ['layout_id', 'structure'],
+                },
+            },
+            {
+                name: 'wordpress_build_mega_menu',
+                description: 'Build a complete Divi mega menu in one call. Creates (or reuses) a nav menu, adds a top-level item carrying Divi\'s "mega-menu" CSS class, turns each column into a child item and each link into a grandchild, and optionally assigns the menu to a theme location. Divi then renders the top item as a full-width mega menu. Works on Divi 4 and Divi 5.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        menu_name: { type: 'string', description: 'Name of the menu to create or reuse.' },
+                        top_label: { type: 'string', description: 'Label of the top-level mega-menu item (e.g. "Products").' },
+                        top_url: { type: 'string', description: 'Optional URL for the top item. Defaults to "#".' },
+                        columns: {
+                            type: 'array',
+                            description: 'The mega-menu columns: [ { "label": "Plugins", "url": "#", "links": [ { "label": "Respira", "url": "/respira" } ] } ].',
+                        },
+                        location: { type: 'string', description: 'Optional theme menu location slug to assign, e.g. "primary-menu".' },
+                    },
+                    required: ['menu_name', 'top_label', 'columns'],
+                },
+            },
             {
                 name: 'wordpress_update_post',
                 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.',
@@ -6103,6 +6197,45 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                     suffix: args.suffix ?? null,
                     type: args.type ?? 'page',
                 });
+            case 'wordpress_get_translations':
+                return await client.getTranslations(args.id, args.type ?? 'page');
+            case 'wordpress_create_translation':
+                return await client.createTranslation({
+                    source_id: args.source_id,
+                    target_language: args.target_language,
+                    title: args.title ?? null,
+                    type: args.type ?? 'page',
+                });
+            case 'wordpress_update_translation':
+                return await client.updateTranslation({
+                    source_id: args.source_id,
+                    target_language: args.target_language,
+                    title: args.title ?? null,
+                    content: args.content ?? null,
+                    type: args.type ?? 'page',
+                });
+            case 'wordpress_list_theme_builder_templates':
+                return await client.listThemeBuilderTemplates();
+            case 'wordpress_create_theme_builder_template':
+                return await client.createThemeBuilderTemplate({
+                    kind: args.kind,
+                    name: args.name,
+                    assignments: args.assignments ?? null,
+                    structure: args.structure ?? null,
+                });
+            case 'wordpress_update_theme_builder_template':
+                return await client.updateThemeBuilderTemplate({
+                    layout_id: args.layout_id,
+                    structure: args.structure,
+                });
+            case 'wordpress_build_mega_menu':
+                return await client.buildMegaMenu({
+                    menu_name: args.menu_name,
+                    top_label: args.top_label,
+                    top_url: args.top_url ?? undefined,
+                    columns: args.columns,
+                    location: args.location ?? undefined,
+                });
             case 'wordpress_update_post': {
                 const approvalsUrl = client.getApprovalsUrl();
                 const post = await client.updatePost(args.id, args);
@@ -6447,7 +6580,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             case 'wordpress_update_media_batch':
                 return await client.updateMediaBatch(args.items);
             case 'wordpress_delete_media':
-                return await client.deleteMedia(args.id, args.force, args.approval_token);
+                return await client.deleteMedia(args.id);
             // Menu Management
             case 'wordpress_list_menus':
                 return await client.listMenus();
@@ -6884,7 +7017,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'wordpress_update_element',
-                description: 'Update settings or content on one specific element. This is the PRIMARY tool for targeted changes (text, style, image, link, or a custom Elementor widget) and avoids rewriting the full builder document. First use find_element, then target its stable id and send only changed settings. For an Elementor custom/third-party widget, call list_elementor_widgets and get_elementor_widget_schema first; never use extract+inject or rewrite _elementor_data for a one-widget edit. On WPBakery + Uncode, prefer identifier_type "uncode_shortcode_id". Re-read with find_element after writing. Response identifies the resolved live/duplicate target so it cannot be mistaken for a live-page change.\n\nLive-edit confirmation: when respira_allow_direct_edit=1 AND the post is a published original, the first call returns `status: "confirmation_required"` with a `next_call_examples` payload. Re-call with the suggested `edit_target` (and `confirm_live_edit: true` for the live path) to acknowledge. Both params are exposed at the top level here so autonomous flows can complete the handshake through MCP without polluting the `updates` object.',
+                description: 'Update settings or content on a specific element in a page. This is the PRIMARY tool for making content changes (text edits, style changes, image swaps, link updates, etc.). Works with all 12 page builders. First use find_element to locate the element, then pass the same identifier here with the updates object containing the new values. On WPBakery + Uncode pages, prefer identifier_type "uncode_shortcode_id" for stable round-trip matching. Response includes target_id, original_id, edit_target ("live" or "duplicate"), is_duplicate, duplicate_created and post_status so the caller can never mistake a duplicate-routed write for a live-page change.\n\nLive-edit confirmation: when respira_allow_direct_edit=1 AND the post is a published original, the first call returns `status: "confirmation_required"` with a `next_call_examples` payload. Re-call with the suggested `edit_target` (and `confirm_live_edit: true` for the live path) to acknowledge. Both params are exposed at the top level here so autonomous flows can complete the handshake through MCP without polluting the `updates` object.',
                 inputSchema: {
                     type: 'object',
                     properties: {