@respira/wordpress-mcp-server 7.6.2 → 8.0.0

package/dist/server.js

@@ -1628,6 +1628,22 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 },
                 readOnlyHint: true,
             },
+            {
+                name: 'wordpress_search_abilities',
+                description: 'Search the curated WordPress Abilities directory and classify each result as Respira-native, inhaled, unavailable, or replaced by a safer Respira workflow. ' +
+                    'Results include per-site install/inhalation state, the preferred replacement tool when one exists, and the next action needed to make an unavailable ability callable.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        q: { type: 'string', description: 'Free-text capability search.' },
+                        plugin: { type: 'string', description: 'Optional exact plugin slug or name.' },
+                        category: { type: 'string', description: 'Optional exact ability category.' },
+                        kind: { type: 'string', enum: ['read', 'write'], description: 'Optional operation kind.' },
+                        limit: { type: 'number', description: 'Maximum results, 1–100 (default 20).' },
+                    },
+                },
+                readOnlyHint: true,
+            },
             {
                 name: 'wordpress_abilities_gap_report',
                 description: 'Compare the active plugins on this WordPress site against the curated list of plugins known to expose abilities via the WordPress Abilities API (wp_register_ability). ' +
@@ -2006,12 +2022,16 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 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.',
+                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). This rewrites the layout on EVERY page that uses it, and unlike a page edit it goes live immediately: there is no staged duplicate and no approval step, because Divi resolves a global layout by id and a second copy would compete with the original. A snapshot is taken first, so it is reversible with restore_snapshot. The first call is refused unless confirm_live_edit is true. 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).' },
+                        confirm_live_edit: {
+                            type: 'boolean',
+                            description: 'Required. Set true to acknowledge that this rewrites a global layout live on every page that uses it. Tell the user what is about to change before setting it.',
+                        },
                     },
                     required: ['layout_id', 'structure'],
                 },
@@ -2524,6 +2544,326 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 description: 'End the explicit snapshot session started by wordpress_begin_session. Later changes fall back to automatic time-window grouping.',
                 inputSchema: { type: 'object', properties: {} },
             },
+            {
+                name: 'wordpress_list_site_templates',
+                description: 'List native Full Site Editing templates or template parts with hierarchy, source, customization state, public route, block count, and a concurrency fingerprint.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        kind: { type: 'string', enum: ['template', 'template_part'], description: 'Defaults to template.' },
+                        search: { type: 'string' },
+                        area: { type: 'string', description: 'Optional template-part area such as header or footer.' },
+                        customized_only: { type: 'boolean' },
+                        page: { type: 'number' },
+                        per_page: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_list_activity',
+                description: 'List privacy-safe Respira activity with site/resource/tool/outcome/date filters and pagination.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        tool: { type: 'string' },
+                        resource_type: { type: 'string' },
+                        resource_id: { type: 'number' },
+                        outcome: { type: 'string', enum: ['success', 'error'] },
+                        date_from: { type: 'string' },
+                        date_to: { type: 'string' },
+                        page: { type: 'number' },
+                        per_page: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_get_activity',
+                description: 'Get one activity record with compact before/after/diff and links to related snapshots, structural proposals, approvals, and rollback recovery.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'number' } },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_get_site_template',
+                description: 'Read one FSE template or template part as normalized blocks. Returns its source, render route, supported targeted operations, and expected_fingerprint for safe updates.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string', description: 'Canonical theme//slug ID or slug.' },
+                        kind: { type: 'string', enum: ['template', 'template_part'] },
+                    },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_create_site_template',
+                description: 'Stage creation of a native FSE template customization. Structural writes are approval-first; pass dry_run=true to preview or edit_target=live only when Direct Editing is enabled.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        kind: { type: 'string', enum: ['template', 'template_part'] },
+                        slug: { type: 'string' },
+                        title: { type: 'string' },
+                        area: { type: 'string' },
+                        blocks: { type: 'array', items: { type: 'object' } },
+                        content: { type: 'string', description: 'Serialized block markup. Use either content or blocks.' },
+                        verification_marker: { type: 'string', description: 'Expected public marker used for render verification.' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['slug'],
+                },
+            },
+            {
+                name: 'wordpress_update_site_template',
+                description: 'Stage targeted path-addressed FSE block operations with stale-write protection. Operations: set_attributes, replace_block, insert_before, insert_after, insert_inside, remove_block, move_block.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        kind: { type: 'string', enum: ['template', 'template_part'] },
+                        expected_fingerprint: { type: 'string' },
+                        operations: { type: 'array', items: { type: 'object' }, maxItems: 50 },
+                        verification_marker: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['id', 'expected_fingerprint', 'operations'],
+                },
+            },
+            {
+                name: 'wordpress_reset_site_template',
+                description: 'Stage removal of a user FSE customization so the theme-provided template becomes active. Requires the current fingerprint and retains a structural rollback snapshot.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        kind: { type: 'string', enum: ['template', 'template_part'] },
+                        expected_fingerprint: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['id', 'expected_fingerprint'],
+                },
+                destructiveHint: true,
+            },
+            {
+                name: 'wordpress_list_site_patterns',
+                description: 'List native WordPress site patterns, distinguishing editable user patterns from immutable theme/plugin patterns. Returns sync status, source, block count, and fingerprints.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        search: { type: 'string' },
+                        source: { type: 'string', enum: ['user', 'registered', 'theme', 'plugin', 'core'] },
+                        sync_status: { type: 'string', enum: ['synced', 'unsynced', 'registered'] },
+                        page: { type: 'number' },
+                        per_page: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_get_site_pattern',
+                description: 'Read a user, theme, plugin, or core pattern as a path-addressed block tree. User patterns return an expected_fingerprint and references for safe targeted updates.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'string', description: 'User pattern post ID, registered pattern name, or slug.' } },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_create_site_pattern',
+                description: 'Stage creation of a native synced or unsynced user pattern. The write is approval-first, snapshot-backed, read-back verified, and server-render verified.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string' },
+                        slug: { type: 'string' },
+                        sync_status: { type: 'string', enum: ['synced', 'unsynced'] },
+                        blocks: { type: 'array', items: { type: 'object' } },
+                        content: { type: 'string', description: 'Serialized block markup. Use either content or blocks.' },
+                        verification_marker: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'wordpress_update_site_pattern',
+                description: 'Stage targeted path-addressed operations on an editable user pattern with stale-write, wrong-target, snapshot, and render protection.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        expected_fingerprint: { type: 'string' },
+                        operations: { type: 'array', items: { type: 'object' }, maxItems: 50 },
+                        verification_marker: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['id', 'expected_fingerprint', 'operations'],
+                },
+            },
+            {
+                name: 'wordpress_delete_site_pattern',
+                description: 'Stage deletion of an editable user pattern. Referenced patterns are refused unless allow_referenced_delete is explicitly approved; a rollback snapshot is retained.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        expected_fingerprint: { type: 'string' },
+                        allow_referenced_delete: { type: 'boolean' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['id', 'expected_fingerprint'],
+                },
+                destructiveHint: true,
+            },
+            {
+                name: 'wordpress_list_site_navigations',
+                description: 'List native block navigation entities with compact nested items, exact block paths, status, block count, and concurrency fingerprints.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        search: { type: 'string' },
+                        page: { type: 'number' },
+                        per_page: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_get_site_navigation',
+                description: 'Read one native block navigation entity as a compact menu tree plus its lossless path-addressed block document, references, and expected_fingerprint.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'string', description: 'Navigation post ID or slug.' } },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_create_site_navigation',
+                description: 'Stage creation of a native block navigation entity. The write is approval-first, snapshot-backed, read-back verified, and server-render verified.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string' },
+                        slug: { type: 'string' },
+                        blocks: { type: 'array', items: { type: 'object' } },
+                        content: { type: 'string', description: 'Serialized navigation-link/submenu blocks. Use either content or blocks.' },
+                        verification_marker: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'wordpress_update_site_navigation',
+                description: 'Stage exact path-addressed operations on a native block navigation entity while preserving unknown extension blocks and rejecting stale or wrong targets.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        expected_fingerprint: { type: 'string' },
+                        operations: { type: 'array', items: { type: 'object' }, maxItems: 50 },
+                        verification_marker: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['id', 'expected_fingerprint', 'operations'],
+                },
+            },
+            {
+                name: 'wordpress_delete_site_navigation',
+                description: 'Stage deletion of a native block navigation entity. Referenced navigation is refused unless allow_referenced_delete is explicitly approved; a rollback snapshot is retained.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'string' },
+                        expected_fingerprint: { type: 'string' },
+                        allow_referenced_delete: { type: 'boolean' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['id', 'expected_fingerprint'],
+                },
+                destructiveHint: true,
+            },
+            {
+                name: 'wordpress_list_design_tokens',
+                description: 'List native Gutenberg theme.json color, typography, spacing, or breakpoint tokens. This is the first-class agent surface over Respira’s existing theme.json variable store.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { type: { type: 'string', enum: ['color', 'typography', 'spacing', 'breakpoints'] } },
+                    required: ['type'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'wordpress_create_design_token',
+                description: 'Create a user-managed native Gutenberg theme.json design token through approval and structural snapshot protection.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', enum: ['color', 'typography', 'spacing', 'breakpoints'] },
+                        id: { type: 'string' },
+                        name: { type: 'string' },
+                        value: {},
+                        expected_fingerprint: { type: 'string', description: 'Optional document revision returned by wordpress_list_design_tokens.' },
+                        approval_token: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['type', 'name', 'value'],
+                },
+            },
+            {
+                name: 'wordpress_update_design_token',
+                description: 'Update a user-managed native Gutenberg theme.json design token with document revision, approval, snapshot, and render verification.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', enum: ['color', 'typography', 'spacing', 'breakpoints'] },
+                        id: { type: 'string' },
+                        name: { type: 'string' },
+                        value: {},
+                        expected_fingerprint: { type: 'string' },
+                        approval_token: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['type', 'id', 'expected_fingerprint'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'wordpress_delete_design_token',
+                description: 'Delete a user-managed native Gutenberg theme.json design token through approval and structural snapshot protection.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', enum: ['color', 'typography', 'spacing', 'breakpoints'] },
+                        id: { type: 'string' },
+                        expected_fingerprint: { type: 'string' },
+                        approval_token: { type: 'string' },
+                        dry_run: { type: 'boolean' },
+                        edit_target: { type: 'string', enum: ['approval', 'live'] },
+                    },
+                    required: ['type', 'id', 'expected_fingerprint'],
+                },
+                destructiveHint: true,
+            },
             {
                 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" } }] }.',
@@ -3031,7 +3371,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'wordpress_activate_plugin',
-                description: 'EXPERIMENTAL: Activate a plugin. Requires plugin management to be enabled in Respira settings. Approval-gated: first call returns `respira_approval_required` with an `approval_token`; call again with the same `slug` plus that token to complete activation. Monitor the site after activation.',
+                description: 'EXPERIMENTAL: Safely activate a plugin. Respira checks declared PHP, WordPress, dependency and companion-plugin compatibility, activates in a fresh loopback request, probes REST and frontend boot, and automatically deactivates the plugin if the site fails. Approval-gated. Use force_without_probe only after explicit operator approval on a host that blocks loopback requests.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -3043,6 +3383,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'string',
                             description: 'Second-step approval token returned by the first call. Echo it back unchanged with the same slug to complete activation.',
                         },
+                        force_without_probe: {
+                            type: 'boolean',
+                            description: 'High-risk override for hosts that block loopback verification. Default false.',
+                        },
                     },
                     required: ['slug'],
                 },
@@ -4913,7 +5257,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'woocommerce_sales_report',
-                description: 'Get WooCommerce sales report for week/month/year/custom range.',
+                description: 'Deprecated compatibility alias for woocommerce_revenue_summary. Retained for two minor releases.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -4924,6 +5268,176 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 },
                 readOnlyHint: true,
             },
+            {
+                name: 'woocommerce_revenue_summary',
+                description: 'Bounded HPOS-compatible revenue summary with currency, store timezone, exact date boundaries, included statuses, pagination coverage, and explicit gross/discount/refund/tax/shipping/net definitions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        date_start: { type: 'string', description: 'ISO date/time in the store timezone. Defaults to 30 days ago.' },
+                        date_end: { type: 'string', description: 'ISO date/time in the store timezone. Defaults to now.' },
+                        statuses: { type: 'array', items: { type: 'string' } },
+                        max_orders: { type: 'number', description: 'Bounded coverage cap, 1-10000. Defaults to 2000.' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_sales_timeseries',
+                description: 'Revenue timeseries grouped by day, week, or month in the WooCommerce store timezone.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        date_start: { type: 'string' },
+                        date_end: { type: 'string' },
+                        statuses: { type: 'array', items: { type: 'string' } },
+                        interval: { type: 'string', enum: ['day', 'week', 'month'] },
+                        max_orders: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_top_products',
+                description: 'Rank products by bounded net sales with quantity, gross sales, net sales, and order counts.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        date_start: { type: 'string' },
+                        date_end: { type: 'string' },
+                        statuses: { type: 'array', items: { type: 'string' } },
+                        max_orders: { type: 'number' },
+                        limit: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_orders_summary',
+                description: 'Order count, status distribution, revenue metrics, coverage, currency, timezone, and date definitions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        date_start: { type: 'string' },
+                        date_end: { type: 'string' },
+                        statuses: { type: 'array', items: { type: 'string' } },
+                        max_orders: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_customers_summary',
+                description: 'Privacy-safe active, repeat-in-range, one-time, and guest customer counts. Never returns names or emails.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        date_start: { type: 'string' },
+                        date_end: { type: 'string' },
+                        statuses: { type: 'array', items: { type: 'string' } },
+                        max_orders: { type: 'number' },
+                    },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_store_configuration',
+                description: 'Read sanitized WooCommerce currency, timezone, tax, units, checkout, page, and HPOS configuration. Credentials and secrets are never returned.',
+                inputSchema: { type: 'object', properties: {} },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_list_payment_gateways',
+                description: 'List payment gateway IDs, public titles, enabled state, and supported features without settings, credentials, or tokens.',
+                inputSchema: { type: 'object', properties: {} },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_list_shipping_zones',
+                description: 'List WooCommerce shipping zones, locations, and public method state.',
+                inputSchema: { type: 'object', properties: {} },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_list_tax_rates',
+                description: 'List WooCommerce tax rates for a tax class without exposing sensitive configuration.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { tax_class: { type: 'string', description: 'Empty for standard rates.' } },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_list_webhooks',
+                description: 'List native WooCommerce webhooks. Secrets are never returned.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { page: { type: 'number' }, per_page: { type: 'number' } },
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_get_webhook',
+                description: 'Read one native WooCommerce webhook without its secret.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'number' } },
+                    required: ['id'],
+                },
+                readOnlyHint: true,
+            },
+            {
+                name: 'woocommerce_create_webhook',
+                description: 'Create a native WooCommerce webhook. Requires an approval-token round trip, an allowlisted topic, and a public HTTPS target. Secret is write-only.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        name: { type: 'string' },
+                        topic: { type: 'string' },
+                        delivery_url: { type: 'string' },
+                        secret: { type: 'string' },
+                        approval_token: { type: 'string' },
+                    },
+                    required: ['topic', 'delivery_url'],
+                },
+            },
+            {
+                name: 'woocommerce_update_webhook',
+                description: 'Update a native WooCommerce webhook through an approval-token round trip. Targets must remain HTTPS and secrets remain write-only.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        id: { type: 'number' },
+                        name: { type: 'string' },
+                        topic: { type: 'string' },
+                        delivery_url: { type: 'string' },
+                        status: { type: 'string', enum: ['active', 'paused', 'disabled'] },
+                        secret: { type: 'string' },
+                        approval_token: { type: 'string' },
+                    },
+                    required: ['id'],
+                },
+                idempotentHint: true,
+            },
+            {
+                name: 'woocommerce_delete_webhook',
+                description: 'Delete a native WooCommerce webhook through an approval-token round trip.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'number' }, approval_token: { type: 'string' } },
+                    required: ['id'],
+                },
+                destructiveHint: true,
+            },
+            {
+                name: 'woocommerce_test_webhook',
+                description: 'Send a rate-limited redacted test payload to a webhook target through an approval-token round trip. Test payloads are not stored.',
+                inputSchema: {
+                    type: 'object',
+                    properties: { id: { type: 'number' }, approval_token: { type: 'string' } },
+                    required: ['id'],
+                },
+            },
             // --- Brands (addon v3.0) ---
             {
                 name: 'woocommerce_list_brands',
@@ -5128,7 +5642,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             // --- Storefront intelligence (addon v3.0 exposes existing REST tools) ---
             {
                 name: 'woocommerce_analyze_shop_page',
-                description: 'Analyze the shop page through the page-builder layer: product grids, hierarchy score, issues, recommendations.',
+                description: 'Analyze the shop page: product grids, hierarchy score, issues, recommendations. Works on a block theme by reading the native archive-product template (Product Collection / Product Template blocks), and falls back to the page-builder layer on builder-built shops. A pure FSE storefront is supported, not a fallback.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -5151,7 +5665,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'woocommerce_update_product_card_layout',
-                description: 'Change product grid layout (columns, rows, ordering) on archive pages through the page-builder layer. Snapshots; dry_run supported.',
+                description: 'Change product grid layout (columns, rows, ordering) on archive pages. On a block theme this edits the native archive-product template by exact block path, fingerprint-guarded and verified after the write; on builder-built shops it falls back to the page-builder layer. Snapshots; dry_run supported.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -5164,7 +5678,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'woocommerce_add_low_stock_badge',
-                description: 'Find products under a stock threshold and produce badge data (e.g. "Only 3 left") for product cards.',
+                description: 'Preview or add a low-stock badge to WooCommerce product cards. Block themes only: this writes into the native archive-product template and has no page-builder path. Use dry_run=true to inspect affected products without writing. A non-dry-run call succeeds only after the badge is inserted and verified; an unsupported template returns an explicit error and never reports a false success.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -5175,11 +5689,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                         dry_run: { type: 'boolean' },
                     },
                 },
-                readOnlyHint: true,
             },
             {
                 name: 'woocommerce_add_sale_badge',
-                description: 'List on-sale products with computed discount percentages and badge data for product cards.',
+                description: 'Preview or add a sale badge to WooCommerce product cards. Block themes only: this writes into the native archive-product template and has no page-builder path. Requires the WooCommerce sale-badge block to be registered on the site. Use dry_run=true to inspect on-sale products. A non-dry-run call succeeds only after the template is changed and verified; an unsupported template returns an explicit error without mutation.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -5187,11 +5700,32 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                         dry_run: { type: 'boolean' },
                     },
                 },
+            },
+            {
+                name: 'woocommerce_analyze_storefront_card',
+                description: 'Report the field composition of the WooCommerce product card on a block theme: which canonical blocks it is built from (woocommerce/product-image, product-title, product-price, product-button, and so on), their exact block paths, and their render order. Read-only. Call this before update_storefront_card_field so you address a field that actually exists.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
                 readOnlyHint: true,
             },
+            {
+                name: 'woocommerce_update_storefront_card_field',
+                description: 'Set attributes on one named field of the WooCommerce product card, addressed by its CANONICAL block name (for example woocommerce/product-image or woocommerce/product-price), on a block theme. Requested attributes are intersected with the attributes the installed block actually registers, so an unknown key is refused rather than written and reported as success. Snapshot, fingerprint guard, dry_run and render verification all apply.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        field: { type: 'string', description: 'Canonical block name, e.g. "woocommerce/product-image". Use analyze_storefront_card to list what this card has.' },
+                        attributes: { type: 'object', description: 'Attributes to set on that block.' },
+                        dry_run: { type: 'boolean' },
+                    },
+                    required: ['field', 'attributes'],
+                },
+            },
             {
                 name: 'woocommerce_update_checkout_layout',
-                description: 'Apply layout changes to the checkout page through the page-builder layer. Snapshots; dry_run supported.',
+                description: 'Preview or apply targeted checkout layout changes. Use dry_run=true first. The tool never reports success for intent-only or no-op writes; unsupported layouts return respira_woo_fse_write_not_supported without changing checkout content.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -5791,13 +6325,24 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'woocommerce_get_feed_status',
-                description: 'Per-format feed URLs, row counts, generation times, running build progress, and wp-cron health warnings.',
+                description: 'Per-format feed URLs, row counts, generation times, running build progress, Action Scheduler health, last successful build, pending/failed/overdue actions, and stale-lock state. This tool is read-only.',
                 inputSchema: {
                     type: 'object',
                     properties: {},
                 },
                 readOnlyHint: true,
             },
+            {
+                name: 'woocommerce_repair_feed_scheduler',
+                description: 'Safely clear a confirmed-stale Respira feed lock and idempotently resume the existing build. Does not delete Action Scheduler history. Returns a verified mutation envelope; returns a non-success response when no stale lock exists.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        dry_run: { type: 'boolean', description: 'Inspect whether a stale lock would be repaired without changing scheduler state.' },
+                    },
+                },
+                idempotentHint: true,
+            },
             {
                 name: 'woocommerce_validate_feed',
                 description: 'Check a catalog sample against one feed format\'s requirements (identifiers, images, descriptions, titles, category mapping) with per-check failing product IDs, so the catalog tools can fix them.',
@@ -6154,6 +6699,8 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.getDiviMigrationReadiness();
             case 'wordpress_abilities_gap_report':
                 return await client.getAbilitiesGapReport();
+            case 'wordpress_search_abilities':
+                return await client.searchAbilities(args);
             case 'wordpress_invoke_ability':
                 return await client.invokeInhaledAbility(args?.ability, args?.args || {});
             case 'wordpress_list_pages':
@@ -6235,6 +6782,9 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.updateThemeBuilderTemplate({
                     layout_id: args.layout_id,
                     structure: args.structure,
+                    // Accept the camelCase and bare-`confirmed` spellings too: agents
+                    // reliably send those, and the plugin already normalises all three.
+                    confirm_live_edit: args.confirm_live_edit ?? args.confirmLiveEdit ?? args.confirmed,
                 });
             case 'wordpress_build_mega_menu':
                 return await client.buildMegaMenu({
@@ -6461,7 +7011,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             case 'wordpress_install_plugin':
                 return await client.installPlugin(args.slug_or_url, args.source || 'wordpress.org', args.approval_token);
             case 'wordpress_activate_plugin':
-                return await client.activatePlugin(args.slug, args.approval_token);
+                return await client.activatePlugin(args.slug, args.approval_token, args.force_without_probe);
             case 'wordpress_deactivate_plugin':
                 return await client.deactivatePlugin(args.slug, args.approval_token);
             case 'wordpress_update_plugin':
@@ -6630,6 +7180,52 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.callRestV2('POST', '/snapshots/session/begin', {});
             case 'wordpress_end_session':
                 return await client.callRestV2('POST', '/snapshots/session/end', {});
+            case 'wordpress_list_site_templates':
+                return await client.callRestV2('GET', '/fse/templates', args);
+            case 'wordpress_list_activity':
+                return await client.callRestV1('GET', '/activity', args);
+            case 'wordpress_get_activity':
+                return await client.callRestV1('GET', `/activity/${args.id}`);
+            case 'wordpress_get_site_template':
+                return await client.callRestV2('GET', '/fse/template', args);
+            case 'wordpress_create_site_template':
+                return await client.callRestV2('POST', '/fse/templates', args);
+            case 'wordpress_update_site_template':
+                return await client.callRestV2('PUT', '/fse/template', args);
+            case 'wordpress_reset_site_template':
+                return await client.callRestV2('DELETE', '/fse/template', args);
+            case 'wordpress_list_site_patterns':
+                return await client.callRestV2('GET', '/fse/patterns', args);
+            case 'wordpress_get_site_pattern':
+                return await client.callRestV2('GET', '/fse/pattern', args);
+            case 'wordpress_create_site_pattern':
+                return await client.callRestV2('POST', '/fse/patterns', args);
+            case 'wordpress_update_site_pattern':
+                return await client.callRestV2('PUT', '/fse/pattern', args);
+            case 'wordpress_delete_site_pattern':
+                return await client.callRestV2('DELETE', '/fse/pattern', args);
+            case 'wordpress_list_site_navigations':
+                return await client.callRestV2('GET', '/fse/navigations', args);
+            case 'wordpress_get_site_navigation':
+                return await client.callRestV2('GET', '/fse/navigation', args);
+            case 'wordpress_create_site_navigation':
+                return await client.callRestV2('POST', '/fse/navigations', args);
+            case 'wordpress_update_site_navigation':
+                return await client.callRestV2('PUT', '/fse/navigation', args);
+            case 'wordpress_delete_site_navigation':
+                return await client.callRestV2('DELETE', '/fse/navigation', args);
+            case 'wordpress_list_design_tokens':
+                return await client.callRestV2('GET', `/design-tokens/${encodeURIComponent(args.type)}`);
+            case 'wordpress_create_design_token': {
+                const { type, ...token } = args;
+                return await client.callRestV2('POST', `/design-tokens/${encodeURIComponent(type)}`, token);
+            }
+            case 'wordpress_update_design_token': {
+                const { type, id, ...patch } = args;
+                return await client.callRestV2('PUT', `/design-tokens/${encodeURIComponent(type)}/${encodeURIComponent(id)}`, patch);
+            }
+            case 'wordpress_delete_design_token':
+                return await client.callRestV2('DELETE', `/design-tokens/${encodeURIComponent(args.type)}/${encodeURIComponent(args.id)}`, args);
             case 'wordpress_apply_builder_patch':
                 return await client.applyBuilderPatch(args.builder, args.post_id, args.operations, args.include, args.edit_target);
             case 'woocommerce_list_products':
@@ -6682,6 +7278,38 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             }
             case 'woocommerce_sales_report':
                 return await client.woocommerceSalesReport(args);
+            case 'woocommerce_revenue_summary':
+                return await client.callRestV1('GET', '/woocommerce/reports/revenue-summary', args);
+            case 'woocommerce_sales_timeseries':
+                return await client.callRestV1('GET', '/woocommerce/reports/sales-timeseries', args);
+            case 'woocommerce_top_products':
+                return await client.callRestV1('GET', '/woocommerce/reports/top-products', args);
+            case 'woocommerce_orders_summary':
+                return await client.callRestV1('GET', '/woocommerce/reports/orders-summary', args);
+            case 'woocommerce_customers_summary':
+                return await client.callRestV1('GET', '/woocommerce/reports/customers-summary', args);
+            case 'woocommerce_get_store_configuration':
+                return await client.callRestV1('GET', '/woocommerce/configuration/store');
+            case 'woocommerce_list_payment_gateways':
+                return await client.callRestV1('GET', '/woocommerce/configuration/payment-gateways');
+            case 'woocommerce_list_shipping_zones':
+                return await client.callRestV1('GET', '/woocommerce/configuration/shipping-zones');
+            case 'woocommerce_list_tax_rates':
+                return await client.callRestV1('GET', '/woocommerce/configuration/tax-rates', args);
+            case 'woocommerce_list_webhooks':
+                return await client.callRestV1('GET', '/woocommerce/webhooks', args);
+            case 'woocommerce_get_webhook':
+                return await client.callRestV1('GET', `/woocommerce/webhooks/${args.id}`);
+            case 'woocommerce_create_webhook':
+                return await client.callRestV1('POST', '/woocommerce/webhooks', args);
+            case 'woocommerce_update_webhook': {
+                const { id, ...payload } = args;
+                return await client.callRestV1('PUT', `/woocommerce/webhooks/${id}`, payload);
+            }
+            case 'woocommerce_delete_webhook':
+                return await client.callRestV1('DELETE', `/woocommerce/webhooks/${args.id}`, { approval_token: args.approval_token });
+            case 'woocommerce_test_webhook':
+                return await client.callRestV1('POST', `/woocommerce/webhooks/${args.id}/test`, { approval_token: args.approval_token });
             // --- WooCommerce Add-on v3.0 ---
             case 'woocommerce_list_brands':
                 return await client.woocommerceListBrands(args);
@@ -6725,6 +7353,10 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.woocommerceAddSaleBadge(args);
             case 'woocommerce_update_checkout_layout':
                 return await client.woocommerceUpdateCheckoutLayout(args);
+            case 'woocommerce_analyze_storefront_card':
+                return await client.woocommerceAnalyzeStorefrontCard(args);
+            case 'woocommerce_update_storefront_card_field':
+                return await client.woocommerceUpdateStorefrontCardField(args);
             case 'woocommerce_set_product_attributes': {
                 const { id, ...payload } = args;
                 return await client.woocommerceSetProductAttributes(id, payload);
@@ -6849,6 +7481,8 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.woocommerceGenerateFeed(args);
             case 'woocommerce_get_feed_status':
                 return await client.woocommerceGetFeedStatus();
+            case 'woocommerce_repair_feed_scheduler':
+                return await client.woocommerceRepairFeedScheduler(args);
             case 'woocommerce_validate_feed':
                 return await client.woocommerceValidateFeed(args);
             case 'woocommerce_set_feed_category_mapping':
@@ -6900,11 +7534,26 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return r;
             }
             case 'wordpress_move_element': {
-                const { post_id, ...rest } = args;
-                return await client.callRestV2('POST', `/builder/elements/move/${post_id}`, rest);
+                // Same edit_target/editTarget normalization as update_element: the
+                // plugin's next_call_examples suggests camelCase editTarget, agents
+                // may send either, the plugin reads editTarget first. Before this fix
+                // neither param was in the schema at all, so strict MCP clients
+                // rejected the confirmation-handshake retry and live moves could
+                // never complete (C.Y., Mainely Social).
+                const { post_id, edit_target, editTarget, ...rest } = args;
+                const resolvedEditTarget = edit_target ?? editTarget;
+                const payload = { ...rest };
+                if (resolvedEditTarget !== undefined) {
+                    payload.editTarget = resolvedEditTarget;
+                }
+                return await client.callRestV2('POST', `/builder/elements/move/${post_id}`, payload);
             }
             case 'wordpress_duplicate_element': {
-                const { post_id, ...rest } = args;
+                const { post_id, edit_target, editTarget, ...rest } = args;
+                const resolvedEditTarget = edit_target ?? editTarget;
+                if (resolvedEditTarget !== undefined) {
+                    rest.editTarget = resolvedEditTarget;
+                }
                 // Pre-mcp-6.19.7 the tool exposed a single `element_id` arg, but the
                 // plugin route /builder/elements/duplicate/{id} has always required
                 // identifier_type + identifier_value (it inherits the same auth and
@@ -6921,15 +7570,27 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                 return await client.callRestV2('POST', `/builder/elements/duplicate/${post_id}`, rest);
             }
             case 'wordpress_remove_element': {
-                const { post_id, ...rest } = args;
+                const { post_id, edit_target, editTarget, ...rest } = args;
+                const resolvedEditTarget = edit_target ?? editTarget;
+                if (resolvedEditTarget !== undefined) {
+                    rest.editTarget = resolvedEditTarget;
+                }
                 return await client.callRestV2('POST', `/builder/elements/remove/${post_id}`, rest);
             }
             case 'wordpress_batch_update': {
-                const { post_id, ...rest } = args;
+                const { post_id, edit_target, editTarget, ...rest } = args;
+                const resolvedEditTarget = edit_target ?? editTarget;
+                if (resolvedEditTarget !== undefined) {
+                    rest.editTarget = resolvedEditTarget;
+                }
                 return await client.callRestV2('POST', `/builder/elements/batch/${post_id}`, rest);
             }
             case 'wordpress_reorder_elements': {
-                const { post_id, ...rest } = args;
+                const { post_id, edit_target, editTarget, ...rest } = args;
+                const resolvedEditTarget = edit_target ?? editTarget;
+                if (resolvedEditTarget !== undefined) {
+                    rest.editTarget = resolvedEditTarget;
+                }
                 return await client.callRestV2('POST', `/builder/elements/reorder/${post_id}`, rest);
             }
             case 'wordpress_build_page':
@@ -7059,7 +7720,7 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
             },
             {
                 name: 'wordpress_move_element',
-                description: 'Move an element to a different container or position within the page. Locate the element using the same identifier_type/identifier_value pattern as respira_find_element / respira_remove_element. The destination is a container PATH (e.g. "0.1" for sections[0].rows[1], or "root"/empty for top level), not a container element id.',
+                description: 'Move an element to a different container or position within the page. Locate the element using the same identifier_type/identifier_value pattern as respira_find_element / respira_remove_element. The destination is a container PATH (e.g. "0.1" for sections[0].rows[1], or "root"/empty for top level), not a container element id.\n\nLive-edit confirmation: when writing to a published original, the first call can return `status: "confirmation_required"` with a `next_call_examples` payload. Re-call with `edit_target` (and `confirm_live_edit: true` for the live path) to acknowledge. Both params are exposed at the top level here; earlier schemas omitted them, so agents saw the handshake but could never complete it (C.Y., Elementor, bug: infinite confirmation loop).',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -7081,6 +7742,20 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'number',
                             description: 'Position index within the target container (0-based). Pass -1 to append.',
                         },
+                        edit_target: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'Where to apply the write. "duplicate" (default) routes the edit to the Respira duplicate of the original (or auto-creates one). "live" writes straight to the published original (requires Respira → Settings → Allow direct edit, or the original to be a draft / existing duplicate).',
+                        },
+                        editTarget: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'CamelCase alias of edit_target (matches the plugin\'s next_call_examples payload). Prefer edit_target.',
+                        },
+                        confirm_live_edit: {
+                            type: 'boolean',
+                            description: 'Required when responding to a `confirmation_required` reply on the live path. Pass `true` alongside `edit_target: "live"` to acknowledge the published-original write.',
+                        },
                     },
                     required: ['post_id', 'identifier_type', 'identifier_value', 'target_container_path', 'position'],
                 },
@@ -7105,6 +7780,20 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'string',
                             description: 'DEPRECATED — pre-mcp-6.19.7 single-arg form. Equivalent to identifier_type:"id" + identifier_value:<this>. Kept for back-compat; new callers should use the explicit pair.',
                         },
+                        edit_target: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'Where to apply the write. "duplicate" (default) routes the edit to the Respira duplicate of the original (or auto-creates one). "live" writes straight to the published original (requires Respira → Settings → Allow direct edit, or the original to be a draft / existing duplicate). Needed to complete a `confirmation_required` handshake.',
+                        },
+                        editTarget: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'CamelCase alias of edit_target (matches the plugin\'s next_call_examples payload). Prefer edit_target.',
+                        },
+                        confirm_live_edit: {
+                            type: 'boolean',
+                            description: 'Pass `true` alongside `edit_target: "live"` to acknowledge a published-original write when the first call returned `confirmation_required`.',
+                        },
                     },
                     required: ['post_id'],
                 },
@@ -7125,6 +7814,20 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             type: 'string',
                             description: 'Value matching the chosen identifier_type (e.g. the element ID, the class name, the text to match).',
                         },
+                        edit_target: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'Where to apply the write. "duplicate" (default) routes the edit to the Respira duplicate of the original (or auto-creates one). "live" writes straight to the published original (requires Respira → Settings → Allow direct edit, or the original to be a draft / existing duplicate). Needed to complete a `confirmation_required` handshake.',
+                        },
+                        editTarget: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'CamelCase alias of edit_target (matches the plugin\'s next_call_examples payload). Prefer edit_target.',
+                        },
+                        confirm_live_edit: {
+                            type: 'boolean',
+                            description: 'Pass `true` alongside `edit_target: "live"` to acknowledge a published-original write when the first call returned `confirmation_required`.',
+                        },
                     },
                     required: ['post_id', 'identifier_type', 'identifier_value'],
                 },
@@ -7154,13 +7857,27 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                                 },
                             },
                         },
+                        edit_target: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'Where to apply the write. "duplicate" (default) routes the edit to the Respira duplicate of the original (or auto-creates one). "live" writes straight to the published original (requires Respira → Settings → Allow direct edit, or the original to be a draft / existing duplicate). Needed to complete a `confirmation_required` handshake.',
+                        },
+                        editTarget: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'CamelCase alias of edit_target (matches the plugin\'s next_call_examples payload). Prefer edit_target.',
+                        },
+                        confirm_live_edit: {
+                            type: 'boolean',
+                            description: 'Pass `true` alongside `edit_target: "live"` to acknowledge a published-original write when the first call returned `confirmation_required`.',
+                        },
                     },
                     required: ['post_id', 'operations'],
                 },
             },
             {
                 name: 'wordpress_reorder_elements',
-                description: 'Reorder child elements within a container. The container is identified by its PATH inside the page (e.g. "0.1" for sections[0].rows[1], or "root"/"" for the top level).',
+                description: 'Reorder child elements within a container. The container is identified by its PATH inside the page (e.g. "0.1" for sections[0].rows[1], or "root"/"" for the top level).\n\nLive-edit confirmation: when writing to a published original, the first call can return `status: "confirmation_required"`. Re-call with `edit_target` (and `confirm_live_edit: true` for the live path) to acknowledge. Both params are exposed at the top level here; earlier schemas omitted them, so agents could never complete the handshake.',
                 inputSchema: {
                     type: 'object',
                     properties: {
@@ -7174,6 +7891,20 @@ Allowlist: css, scss, less, json. PHP / JS theme writes are intentionally out of
                             description: 'Array of element IDs in the desired order.',
                             items: { type: 'string' },
                         },
+                        edit_target: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'Where to apply the write. "duplicate" (default) routes the edit to the Respira duplicate of the original (or auto-creates one). "live" writes straight to the published original (requires Respira → Settings → Allow direct edit, or the original to be a draft / existing duplicate).',
+                        },
+                        editTarget: {
+                            type: 'string',
+                            enum: ['live', 'duplicate'],
+                            description: 'CamelCase alias of edit_target (matches the plugin\'s next_call_examples payload). Prefer edit_target.',
+                        },
+                        confirm_live_edit: {
+                            type: 'boolean',
+                            description: 'Required when responding to a `confirmation_required` reply on the live path. Pass `true` alongside `edit_target: "live"` to acknowledge the published-original write.',
+                        },
                     },
                     required: ['post_id', 'container_path', 'new_order'],
                 },