true, 'type' => 'tool' ]; } if (!isset($args['meta']['expose_in_deprecated_woocommerce_mcp'])) { $args['meta']['expose_in_deprecated_woocommerce_mcp'] = true; } if (!isset($args['meta']['plugin_name'])) { if (strpos($name, 'woocommerce/') === 0) { $args['meta']['plugin_name'] = 'WooCommerce'; } else { $args['meta']['plugin_name'] = 'Aiutoma'; } } if (function_exists('wp_has_ability') && wp_has_ability($name)) { return; } if (function_exists('wp_register_ability')) { wp_register_ability($name, $args); } } public function __construct() { $this->init_schema_resilience(); add_action('wp_abilities_api_categories_init', [$this, 'register_abilities_categories']); add_action('wp_abilities_api_init', [$this, 'register_abilities']); add_action('wp_abilities_api_init', [$this, 'register_standard_ability_aliases'], 100); } /** * Initialize schema resilience filters to prevent MCP schema validation blocks. */ public function init_schema_resilience() { // 1. Ensure any ability registered without input_schema has a default object schema, // and relax woocommerce/products-query price schemas add_filter('wp_register_ability_args', function($args, $name) { if (!is_array($args)) { return $args; } // Provide default input schema for abilities missing one (e.g. mcp-adapter/discover-abilities) if (empty($args['input_schema'])) { $args['input_schema'] = [ 'type' => 'object', 'properties' => (object)[], ]; } // Relax woocommerce/products-query and related product query output price schemas to allow string, number, null if (strpos($name, 'woocommerce/') === 0 && isset($args['output_schema']) && is_array($args['output_schema'])) { $relax_prices = function(&$schema) use (&$relax_prices) { if (!is_array($schema)) return; if (isset($schema['properties']) && is_array($schema['properties'])) { foreach (['price', 'regular_price', 'sale_price'] as $p_key) { if (isset($schema['properties'][$p_key]) && is_array($schema['properties'][$p_key])) { $schema['properties'][$p_key]['type'] = ['string', 'number', 'null']; } } foreach ($schema['properties'] as &$sub) { $relax_prices($sub); } } if (isset($schema['items']) && is_array($schema['items'])) { $relax_prices($schema['items']); } }; $relax_prices($args['output_schema']); } return $args; }, 10, 2); // 2. Prevent failure when empty input [] or {} is passed to an ability without schema add_filter('wp_ability_validate_input', function($is_valid, $input, $ability_name) { if (is_wp_error($is_valid) && $is_valid->get_error_code() === 'ability_missing_input_schema') { if (empty($input) || (is_array($input) && count($input) === 0)) { return true; } } return $is_valid; }, 10, 3); // 3. Normalize empty array input to null if the ability defines no input schema add_filter('wp_ability_normalize_input', function($input, $ability_name, $ability) { if (is_array($input) && empty($input)) { $schema = method_exists($ability, 'get_input_schema') ? $ability->get_input_schema() : null; if (empty($schema)) { return null; } } return $input; }, 10, 3); // 4. Ensure minor price type mismatches in output validation don't break response add_filter('wp_ability_validate_output', function($is_valid, $output, $ability_name) { if (is_wp_error($is_valid)) { $msg = $is_valid->get_error_message(); if ((strpos($msg, '[price]') !== false || strpos($msg, '[regular_price]') !== false || strpos($msg, '[sale_price]') !== false) && (strpos($msg, 'string') !== false || strpos($msg, 'tipo string') !== false)) { return true; } } return $is_valid; }, 10, 3); } public function register_abilities_categories() { if (!wp_has_ability_category('aiutoma')) { wp_register_ability_category('aiutoma', [ 'label' => __('Aiutoma', 'aiutoma'), 'description' => __('Aiutoma Abilities', 'aiutoma') ]); } if (!wp_has_ability_category('wpml')) { wp_register_ability_category('wpml', [ 'label' => __('WPML', 'aiutoma'), 'description' => __('WPML Abilities', 'aiutoma') ]); } if (!wp_has_ability_category('woocommerce')) { wp_register_ability_category('woocommerce', [ 'label' => __('WooCommerce', 'aiutoma'), 'description' => __('WooCommerce Abilities', 'aiutoma') ]); } if (!wp_has_ability_category('gutenberg')) { wp_register_ability_category('gutenberg', [ 'label' => __('Gutenberg', 'aiutoma'), 'description' => __('Gutenberg Abilities', 'aiutoma') ]); } } public function register_abilities() { try { $registrar = new class { use Abilities\Core; use Abilities\WordPress; use Abilities\WooCommerce; use Abilities\Wpml; use Abilities\Gutenberg; }; $registrar->register_core_abilities(); $registrar->register_wordpress_abilities(); $registrar->register_woocommerce_abilities(); $registrar->register_wpml_abilities(); $registrar->register_gutenberg_abilities(); do_action('aiutoma_register_abilities'); } catch (\Throwable $e) { } } /** * Register standard ability aliases for cross-version and cross-plugin compatibility. * Ensures abilities like core/content-query <-> core/read-content, core/users-query <-> core/read-users, * and core/settings-get <-> core/read-settings work seamlessly regardless of calling conventions. */ public function register_standard_ability_aliases() { if (!function_exists('wp_has_ability') || !function_exists('wp_get_ability')) { return; } $bidirectional_pairs = [ ['core/content-query', 'core/read-content'], ['core/users-query', 'core/read-users'], ['core/settings-get', 'core/read-settings'], ]; foreach ($bidirectional_pairs as $pair) { $has_0 = wp_has_ability($pair[0]); $has_1 = wp_has_ability($pair[1]); if ($has_0 && !$has_1) { $this->register_ability_alias($pair[1], $pair[0]); } elseif ($has_1 && !$has_0) { $this->register_ability_alias($pair[0], $pair[1]); } } // Unidirectional aliases (e.g. ai/get-post-details -> core/content-query or core/read-content) if (!wp_has_ability('ai/get-post-details')) { if (wp_has_ability('core/content-query')) { $this->register_ability_alias('ai/get-post-details', 'core/content-query'); } elseif (wp_has_ability('core/read-content')) { $this->register_ability_alias('ai/get-post-details', 'core/read-content'); } } } /** * Helper to wrap an existing ability as an alias. * * @param string $alias_name Target alias ability name. * @param string $target_name Source existing ability name. */ private function register_ability_alias($alias_name, $target_name) { $target = wp_get_ability($target_name); if (!$target) { return; } try { self::register($alias_name, [ 'label' => $target->get_label(), 'description' => $target->get_description(), 'category' => $target->get_category(), 'input_schema' => $target->get_input_schema(), 'output_schema' => $target->get_output_schema(), 'meta' => $target->get_meta(), 'permission_callback' => function(...$args) use ($target) { return $target->has_permission(...$args); }, 'execute_callback' => function(...$args) use ($target) { return $target->execute(...$args); }, ]); } catch (\Throwable $e) { // Silently ignore if already registered or failed } } }