@respira/wordpress-mcp-server 7.4.1 → 7.5.1

package/dist/server.js

@@ -15,7 +15,7 @@ import { WordPressClient } from './wordpress-client.js';
 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';
+import { getAcfTools, resolveAcfToolName } from './acf-tools.js';
 import { getUsageEmitter, deriveToolKind } from './usage-emitter.js';
 /**
  * Read the server version from package.json at module load time so the
@@ -5490,6 +5490,94 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 },
                 readOnlyHint: true,
             },
+            // --- Product configurator, STAGGS (addon v3.2) ---
+            {
+                name: 'woocommerce_configurator_status',
+                description: 'Which product configurator is active (STAGGS) plus how many products and attribute groups use it. Start here before any configurator work.',
+                inputSchema: { type: 'object', properties: {} },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_product_configurator',
+                description: "Read a product's STAGGS configurator state: the enabled flag and all sgg_ meta (steps, attributes, themes).",
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'number', description: 'Product ID' } },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_set_product_configurator',
+                description: 'Enable or disable the STAGGS configurator on a product. Supports dry_run. Snapshots the product before and after.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'Product ID' },
+                        enabled: { type: 'boolean' },
+                        dry_run: { type: 'boolean', description: 'Preview without writing (default false)' },
+                    },
+                    required: ['id', 'enabled'],
+                },
+            },
+            {
+                name: 'woocommerce_list_configurator_attributes',
+                description: 'List STAGGS attribute groups (the reusable option sets a configurator is built from): id, title, type.',
+                inputSchema: { type: 'object', properties: {} },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_configurator_attribute_items',
+                description: "Read a STAGGS attribute's option items. The workflow is read, edit the returned array, then write it back with set_configurator_attribute_items, so STAGGS' internal sub-field names never have to be guessed.",
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'number', description: 'STAGGS attribute (sgg_attribute) post ID' } },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_set_configurator_attribute_items',
+                description: "Replace a STAGGS attribute's option items, written through the STAGGS/Carbon Fields helpers so storage stays consistent. Supports dry_run. Snapshots the attribute.",
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number', description: 'STAGGS attribute (sgg_attribute) post ID' },
+                        items: { type: 'array', items: { type: 'object' }, description: 'The full items array (read first, edit, write back)' },
+                        dry_run: { type: 'boolean', description: 'Preview without writing (default false)' },
+                    },
+                    required: ['id', 'items'],
+                },
+            },
+            {
+                name: 'woocommerce_get_plugin_state',
+                description: 'Read allow-listed options and post meta for a known third-party plugin (currently: staggs). Keys outside the allow-list are ignored on read.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        plugin: { type: 'string', description: 'Plugin slug with a registered allow-list (staggs)' },
+                        option_keys: { type: 'array', items: { type: 'string' }, description: 'Option names to read (must match the allow-list prefixes)' },
+                        post_id: { type: 'number', description: 'Optional post whose allow-listed meta to read' },
+                    },
+                    required: ['plugin'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_set_plugin_state',
+                description: 'Write allow-listed options and post meta for a known third-party plugin (currently: staggs). Any key outside the allow-list refuses the whole request. Supports dry_run. Snapshots the post.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        plugin: { type: 'string', description: 'Plugin slug with a registered allow-list (staggs)' },
+                        options: { type: 'object', description: 'Option name to value map' },
+                        meta: { type: 'object', description: 'Meta key to value map (requires post_id)' },
+                        post_id: { type: 'number' },
+                        dry_run: { type: 'boolean', description: 'Preview without writing (default false)' },
+                    },
+                    required: ['plugin'],
+                },
+            },
             // --- Readiness autofix (addon v3.1) ---
             {
                 name: 'woocommerce_readiness_fixlist',
@@ -6505,6 +6593,30 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.woocommerceCreateCartLink(args);
             case 'woocommerce_agent_orders_report':
                 return await client.woocommerceAgentOrdersReport(args);
+            case 'woocommerce_configurator_status':
+                return await client.woocommerceConfiguratorStatus();
+            case 'woocommerce_get_product_configurator':
+                return await client.woocommerceGetProductConfigurator(args.id);
+            case 'woocommerce_set_product_configurator': {
+                const { id, ...payload } = args;
+                return await client.woocommerceSetProductConfigurator(id, payload);
+            }
+            case 'woocommerce_list_configurator_attributes':
+                return await client.woocommerceListConfiguratorAttributes();
+            case 'woocommerce_get_configurator_attribute_items':
+                return await client.woocommerceGetConfiguratorAttributeItems(args.id);
+            case 'woocommerce_set_configurator_attribute_items': {
+                const { id, ...payload } = args;
+                return await client.woocommerceSetConfiguratorAttributeItems(id, payload);
+            }
+            case 'woocommerce_get_plugin_state': {
+                const { plugin, ...params } = args;
+                return await client.woocommerceGetPluginState(plugin, params);
+            }
+            case 'woocommerce_set_plugin_state': {
+                const { plugin, ...payload } = args;
+                return await client.woocommerceSetPluginState(plugin, payload);
+            }
             case 'woocommerce_readiness_fixlist':
                 return await client.woocommerceReadinessFixlist(args);
             case 'woocommerce_set_image_alt': {
@@ -6624,8 +6736,16 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 if (elementorResult !== null) {
                     return elementorResult;
                 }
-                // Check if this is an ACF tool.
-                if (ACF_TOOL_NAMES.has(name)) {
+                // Check if this is an ACF tool. ACF tools live only under the
+                // respira_acf_* namespace (ACF_TOOL_NAMES + wordpress-client ACF_ROUTES
+                // are keyed by respira_acf_*), but normalizeToolName blindly rewrites
+                // respira_* -> wordpress_*, so by the time dispatchToolCall runs an ACF
+                // call arrives as wordpress_acf_*. Map it back so the guard matches and
+                // the plugin dispatch gets the name it expects. Without this every ACF
+                // tool fell through to "Unknown tool: wordpress_acf_*" (kenbi/Pedro,
+                // 2026-07-14; same class as the v7.1.0 fix that regressed).
+                const acfName = resolveAcfToolName(name);
+                if (acfName) {
                     if (!(await this.isAcfAvailable())) {
                         return {
                             __respira_is_error: true,
@@ -6633,7 +6753,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             hint: 'Install Advanced Custom Fields on the target site, then retry. ACF Pro is required for repeaters, flexible content, galleries, and options pages.'
                         };
                     }
-                    return await this.currentSite.dispatchAcfTool(name, args);
+                    return await this.currentSite.dispatchAcfTool(acfName, args);
                 }
                 // Check if this is a widget shortcut (wordpress_add_*).
                 if (name.startsWith('wordpress_add_')) {