<?php

namespace AskTamMCP\MCP;

defined('ABSPATH') || exit;

/**
 * Tool Registry — registers all tools and maps names to handlers.
 *
 * Each tool entry:
 *   name        string  — MCP tool name (snake_case)
 *   description string  — shown to AI clients
 *   scope       string  — required key scope: read|write|admin|woocommerce
 *   inputSchema array   — JSON Schema for arguments
 *   handler     string  — "ClassName::method" or Closure
 */
class Registry {

    /** @var array<string, array> */
    private array $tools = [];

    public function __construct() {
        $this->registerAll();
    }

    // -------------------------------------------------------------------------
    // Public API
    // -------------------------------------------------------------------------

    /** Returns MCP-formatted tool definitions for tools/list response */
    public function getToolDefinitions(): array {
        return array_values(array_map(fn($t) => [
            'name'        => $t['name'],
            'description' => $t['description'],
            'inputSchema' => $t['inputSchema'],
        ], $this->tools));
    }

    /** Returns callable handler for a tool, or null if not found */
    public function getHandler(string $name): ?callable {
        if (!isset($this->tools[$name])) {
            return null;
        }
        $h = $this->tools[$name]['handler'];
        if (is_callable($h)) {
            return $h;
        }
        [$class, $method] = explode('::', $h);
        return [new $class(), $method];
    }

    /** Returns full tool definition array */
    public function getTool(string $name): ?array {
        return $this->tools[$name] ?? null;
    }

    // -------------------------------------------------------------------------
    // Tool Registration
    // -------------------------------------------------------------------------

    private function registerAll(): void {
        $this->registerPostTools();
        $this->registerPageTools();
        $this->registerMediaTools();
        $this->registerUserTools();
        $this->registerTaxonomyTools();
        $this->registerOptionTools();
        $this->registerPluginTools();
        $this->registerThemeTools();
        $this->registerMenuTools();
        $this->registerCommentTools();
        $this->registerSeoTools();
        $this->registerSiteTools();

        if (class_exists('WooCommerce')) {
            $this->registerWooCommerceTools();
        }

        // Allow third-party extensions
        do_action('asktam_mcp_register_tools', $this);
    }

    public function register(array $tool): void {
        $this->tools[$tool['name']] = $tool;
    }

    // -------------------------------------------------------------------------
    // Posts
    // -------------------------------------------------------------------------
    private function registerPostTools(): void {
        $this->register([
            'name'        => 'list_posts',
            'description' => 'List WordPress posts. Supports filtering by status, author, category, tag, date range, and search. Returns id, title, status, date, link.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\PostTools::listPosts',
            'inputSchema' => [
                'type'       => 'object',
                'properties' => [
                    'status'         => ['type' => 'string', 'default' => 'publish', 'description' => 'Post status: publish|draft|pending|private|any'],
                    'per_page'       => ['type' => 'integer', 'default' => 20, 'maximum' => 100],
                    'page'           => ['type' => 'integer', 'default' => 1],
                    'search'         => ['type' => 'string'],
                    'author'         => ['type' => 'integer'],
                    'category_id'    => ['type' => 'integer'],
                    'tag_id'         => ['type' => 'integer'],
                    'orderby'        => ['type' => 'string', 'default' => 'date'],
                    'order'          => ['type' => 'string', 'default' => 'DESC', 'enum' => ['ASC', 'DESC']],
                    'after'          => ['type' => 'string', 'description' => 'ISO 8601 date'],
                    'before'         => ['type' => 'string', 'description' => 'ISO 8601 date'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'get_post',
            'description' => 'Get full details of a WordPress post including content, meta, taxonomies, and featured image.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\PostTools::getPost',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['post_id'],
                'properties' => [
                    'post_id' => ['type' => 'integer'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'create_post',
            'description' => 'Create a new WordPress post. Returns the new post ID and URL.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\PostTools::createPost',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['title'],
                'properties' => [
                    'title'          => ['type' => 'string'],
                    'content'        => ['type' => 'string', 'description' => 'HTML or Gutenberg block content'],
                    'excerpt'        => ['type' => 'string'],
                    'status'         => ['type' => 'string', 'default' => 'draft', 'enum' => ['publish', 'draft', 'pending', 'private']],
                    'author'         => ['type' => 'integer'],
                    'categories'     => ['type' => 'array', 'items' => ['type' => 'integer']],
                    'tags'           => ['type' => 'array', 'items' => ['type' => 'integer']],
                    'meta'           => ['type' => 'object'],
                    'featured_media' => ['type' => 'integer'],
                    'slug'           => ['type' => 'string'],
                    'post_type'      => ['type' => 'string', 'default' => 'post'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'update_post',
            'description' => 'Update an existing WordPress post. Only supplied fields are changed.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\PostTools::updatePost',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['post_id'],
                'properties' => [
                    'post_id'        => ['type' => 'integer'],
                    'title'          => ['type' => 'string'],
                    'content'        => ['type' => 'string'],
                    'excerpt'        => ['type' => 'string'],
                    'status'         => ['type' => 'string'],
                    'categories'     => ['type' => 'array', 'items' => ['type' => 'integer']],
                    'tags'           => ['type' => 'array', 'items' => ['type' => 'integer']],
                    'meta'           => ['type' => 'object'],
                    'featured_media' => ['type' => 'integer'],
                    'slug'           => ['type' => 'string'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'delete_post',
            'description' => 'Delete or trash a WordPress post.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\PostTools::deletePost',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['post_id'],
                'properties' => [
                    'post_id'    => ['type' => 'integer'],
                    'force'      => ['type' => 'boolean', 'default' => false, 'description' => 'true = permanent delete, false = trash'],
                ],
            ],
        ]);
    }

    // -------------------------------------------------------------------------
    // Pages
    // -------------------------------------------------------------------------
    private function registerPageTools(): void {
        $this->register([
            'name'        => 'list_pages',
            'description' => 'List WordPress pages with optional status filter.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\PageTools::listPages',
            'inputSchema' => [
                'type'       => 'object',
                'properties' => [
                    'status'   => ['type' => 'string', 'default' => 'publish'],
                    'per_page' => ['type' => 'integer', 'default' => 20],
                    'page'     => ['type' => 'integer', 'default' => 1],
                    'search'   => ['type' => 'string'],
                    'parent'   => ['type' => 'integer'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'get_page',
            'description' => 'Get a single WordPress page including content and meta.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\PageTools::getPage',
            'inputSchema' => ['type' => 'object', 'required' => ['page_id'], 'properties' => ['page_id' => ['type' => 'integer']]],
        ]);

        $this->register([
            'name'        => 'create_page',
            'description' => 'Create a new WordPress page.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\PageTools::createPage',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['title'],
                'properties' => [
                    'title'    => ['type' => 'string'],
                    'content'  => ['type' => 'string'],
                    'status'   => ['type' => 'string', 'default' => 'draft'],
                    'parent'   => ['type' => 'integer'],
                    'slug'     => ['type' => 'string'],
                    'template' => ['type' => 'string'],
                    'meta'     => ['type' => 'object'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'update_page',
            'description' => 'Update an existing WordPress page.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\PageTools::updatePage',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['page_id'],
                'properties' => [
                    'page_id'  => ['type' => 'integer'],
                    'title'    => ['type' => 'string'],
                    'content'  => ['type' => 'string'],
                    'status'   => ['type' => 'string'],
                    'parent'   => ['type' => 'integer'],
                    'template' => ['type' => 'string'],
                    'meta'     => ['type' => 'object'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'delete_page',
            'description' => 'Delete or trash a WordPress page.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\PageTools::deletePage',
            'inputSchema' => ['type' => 'object', 'required' => ['page_id'], 'properties' => ['page_id' => ['type' => 'integer'], 'force' => ['type' => 'boolean', 'default' => false]]],
        ]);
    }

    // -------------------------------------------------------------------------
    // Media
    // -------------------------------------------------------------------------
    private function registerMediaTools(): void {
        $this->register([
            'name'        => 'list_media',
            'description' => 'List WordPress media library items.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\MediaTools::listMedia',
            'inputSchema' => [
                'type'       => 'object',
                'properties' => [
                    'per_page'   => ['type' => 'integer', 'default' => 20],
                    'page'       => ['type' => 'integer', 'default' => 1],
                    'mime_type'  => ['type' => 'string', 'description' => 'e.g. image/jpeg, application/pdf'],
                    'search'     => ['type' => 'string'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'get_media',
            'description' => 'Get a single media item by ID.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\MediaTools::getMedia',
            'inputSchema' => ['type' => 'object', 'required' => ['media_id'], 'properties' => ['media_id' => ['type' => 'integer']]],
        ]);

        $this->register([
            'name'        => 'upload_media',
            'description' => 'Upload a media file from a public URL. Returns new media ID and URL.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\MediaTools::uploadMedia',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['source_url'],
                'properties' => [
                    'source_url' => ['type' => 'string', 'description' => 'Public URL to download and upload'],
                    'title'      => ['type' => 'string'],
                    'alt_text'   => ['type' => 'string'],
                    'caption'    => ['type' => 'string'],
                    'post_id'    => ['type' => 'integer', 'description' => 'Attach to this post ID'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'update_media',
            'description' => 'Update media metadata: alt text, title, caption, description.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\MediaTools::updateMedia',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['media_id'],
                'properties' => [
                    'media_id'    => ['type' => 'integer'],
                    'title'       => ['type' => 'string'],
                    'alt_text'    => ['type' => 'string'],
                    'caption'     => ['type' => 'string'],
                    'description' => ['type' => 'string'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'delete_media',
            'description' => 'Delete a media item permanently.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\MediaTools::deleteMedia',
            'inputSchema' => ['type' => 'object', 'required' => ['media_id'], 'properties' => ['media_id' => ['type' => 'integer'], 'force' => ['type' => 'boolean', 'default' => true]]],
        ]);
    }

    // -------------------------------------------------------------------------
    // Users
    // -------------------------------------------------------------------------
    private function registerUserTools(): void {
        $this->register([
            'name'        => 'list_users',
            'description' => 'List WordPress users with optional role filter.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\UserTools::listUsers',
            'inputSchema' => [
                'type'       => 'object',
                'properties' => [
                    'role'     => ['type' => 'string', 'description' => 'e.g. administrator, editor, author, subscriber'],
                    'per_page' => ['type' => 'integer', 'default' => 20],
                    'page'     => ['type' => 'integer', 'default' => 1],
                    'search'   => ['type' => 'string'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'get_user',
            'description' => 'Get a single user by ID.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\UserTools::getUser',
            'inputSchema' => ['type' => 'object', 'required' => ['user_id'], 'properties' => ['user_id' => ['type' => 'integer']]],
        ]);

        $this->register([
            'name'        => 'create_user',
            'description' => 'Create a new WordPress user.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\UserTools::createUser',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['username', 'email', 'password'],
                'properties' => [
                    'username'   => ['type' => 'string'],
                    'email'      => ['type' => 'string'],
                    'password'   => ['type' => 'string'],
                    'first_name' => ['type' => 'string'],
                    'last_name'  => ['type' => 'string'],
                    'role'       => ['type' => 'string', 'default' => 'subscriber'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'update_user',
            'description' => 'Update an existing WordPress user.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\UserTools::updateUser',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['user_id'],
                'properties' => [
                    'user_id'    => ['type' => 'integer'],
                    'email'      => ['type' => 'string'],
                    'first_name' => ['type' => 'string'],
                    'last_name'  => ['type' => 'string'],
                    'role'       => ['type' => 'string'],
                    'password'   => ['type' => 'string'],
                    'meta'       => ['type' => 'object'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'delete_user',
            'description' => 'Delete a WordPress user. Reassign their posts to another user.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\UserTools::deleteUser',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['user_id'],
                'properties' => [
                    'user_id'    => ['type' => 'integer'],
                    'reassign'   => ['type' => 'integer', 'description' => 'User ID to reassign posts to'],
                ],
            ],
        ]);
    }

    // -------------------------------------------------------------------------
    // Taxonomy
    // -------------------------------------------------------------------------
    private function registerTaxonomyTools(): void {
        $this->register([
            'name'        => 'list_terms',
            'description' => 'List terms in any taxonomy (category, post_tag, or custom).',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\TaxonomyTools::listTerms',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['taxonomy'],
                'properties' => [
                    'taxonomy' => ['type' => 'string'],
                    'parent'   => ['type' => 'integer'],
                    'search'   => ['type' => 'string'],
                    'per_page' => ['type' => 'integer', 'default' => 50],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'create_term',
            'description' => 'Create a new term in a taxonomy.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\TaxonomyTools::createTerm',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['taxonomy', 'name'],
                'properties' => [
                    'taxonomy'    => ['type' => 'string'],
                    'name'        => ['type' => 'string'],
                    'slug'        => ['type' => 'string'],
                    'description' => ['type' => 'string'],
                    'parent'      => ['type' => 'integer'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'update_term',
            'description' => 'Update an existing term.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\TaxonomyTools::updateTerm',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['taxonomy', 'term_id'],
                'properties' => [
                    'taxonomy'    => ['type' => 'string'],
                    'term_id'     => ['type' => 'integer'],
                    'name'        => ['type' => 'string'],
                    'slug'        => ['type' => 'string'],
                    'description' => ['type' => 'string'],
                    'parent'      => ['type' => 'integer'],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'delete_term',
            'description' => 'Delete a term from a taxonomy.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\TaxonomyTools::deleteTerm',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['taxonomy', 'term_id'],
                'properties' => [
                    'taxonomy' => ['type' => 'string'],
                    'term_id'  => ['type' => 'integer'],
                ],
            ],
        ]);
    }

    // -------------------------------------------------------------------------
    // Options
    // -------------------------------------------------------------------------
    private function registerOptionTools(): void {
        $this->register([
            'name'        => 'get_option',
            'description' => 'Get a WordPress option value by key.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\OptionTools::getOption',
            'inputSchema' => ['type' => 'object', 'required' => ['option_name'], 'properties' => ['option_name' => ['type' => 'string']]],
        ]);

        $this->register([
            'name'        => 'update_option',
            'description' => 'Update a WordPress option.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\OptionTools::updateOption',
            'inputSchema' => ['type' => 'object', 'required' => ['option_name', 'option_value'], 'properties' => ['option_name' => ['type' => 'string'], 'option_value' => ['type' => ['string', 'number', 'boolean', 'object', 'array']]]],
        ]);

        $this->register([
            'name'        => 'list_options',
            'description' => 'List WordPress options matching a pattern prefix.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\OptionTools::listOptions',
            'inputSchema' => ['type' => 'object', 'properties' => ['prefix' => ['type' => 'string', 'description' => 'Option name prefix to filter by']]],
        ]);
    }

    // -------------------------------------------------------------------------
    // Plugins
    // -------------------------------------------------------------------------
    private function registerPluginTools(): void {
        $this->register([
            'name'        => 'list_plugins',
            'description' => 'List all installed WordPress plugins with their status.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\PluginTools::listPlugins',
            'inputSchema' => ['type' => 'object', 'properties' => ['status' => ['type' => 'string', 'enum' => ['all', 'active', 'inactive'], 'default' => 'all']]],
        ]);

        $this->register([
            'name'        => 'activate_plugin',
            'description' => 'Activate a WordPress plugin by its slug/file path.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\PluginTools::activatePlugin',
            'inputSchema' => ['type' => 'object', 'required' => ['plugin'], 'properties' => ['plugin' => ['type' => 'string', 'description' => 'Plugin file path, e.g. woocommerce/woocommerce.php']]],
        ]);

        $this->register([
            'name'        => 'deactivate_plugin',
            'description' => 'Deactivate a WordPress plugin.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\PluginTools::deactivatePlugin',
            'inputSchema' => ['type' => 'object', 'required' => ['plugin'], 'properties' => ['plugin' => ['type' => 'string']]],
        ]);
    }

    // -------------------------------------------------------------------------
    // Themes
    // -------------------------------------------------------------------------
    private function registerThemeTools(): void {
        $this->register([
            'name'        => 'list_themes',
            'description' => 'List all installed WordPress themes.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\ThemeTools::listThemes',
            'inputSchema' => ['type' => 'object', 'properties' => []],
        ]);

        $this->register([
            'name'        => 'get_active_theme',
            'description' => 'Get the currently active WordPress theme details.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\ThemeTools::getActiveTheme',
            'inputSchema' => ['type' => 'object', 'properties' => []],
        ]);

        $this->register([
            'name'        => 'switch_theme',
            'description' => 'Switch the active WordPress theme by stylesheet slug.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\ThemeTools::switchTheme',
            'inputSchema' => ['type' => 'object', 'required' => ['stylesheet'], 'properties' => ['stylesheet' => ['type' => 'string']]],
        ]);
    }

    // -------------------------------------------------------------------------
    // Menus
    // -------------------------------------------------------------------------
    private function registerMenuTools(): void {
        $this->register([
            'name'        => 'list_menus',
            'description' => 'List all WordPress navigation menus.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\MenuTools::listMenus',
            'inputSchema' => ['type' => 'object', 'properties' => []],
        ]);

        $this->register([
            'name'        => 'get_menu',
            'description' => 'Get all items in a navigation menu by menu ID or slug.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\MenuTools::getMenu',
            'inputSchema' => ['type' => 'object', 'required' => ['menu'], 'properties' => ['menu' => ['type' => ['string', 'integer'], 'description' => 'Menu ID or slug']]],
        ]);

        $this->register([
            'name'        => 'update_menu_item',
            'description' => 'Update or create a navigation menu item.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\MenuTools::updateMenuItem',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['menu', 'title', 'url'],
                'properties' => [
                    'menu'      => ['type' => ['string', 'integer']],
                    'item_id'   => ['type' => 'integer', 'description' => 'Omit to create new item'],
                    'title'     => ['type' => 'string'],
                    'url'       => ['type' => 'string'],
                    'parent'    => ['type' => 'integer'],
                    'position'  => ['type' => 'integer'],
                ],
            ],
        ]);
    }

    // -------------------------------------------------------------------------
    // Comments
    // -------------------------------------------------------------------------
    private function registerCommentTools(): void {
        $this->register([
            'name'        => 'list_comments',
            'description' => 'List WordPress comments with optional post and status filters.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\CommentTools::listComments',
            'inputSchema' => [
                'type'       => 'object',
                'properties' => [
                    'post_id'  => ['type' => 'integer'],
                    'status'   => ['type' => 'string', 'default' => 'approve', 'enum' => ['approve', 'hold', 'spam', 'trash', 'all']],
                    'per_page' => ['type' => 'integer', 'default' => 20],
                    'page'     => ['type' => 'integer', 'default' => 1],
                ],
            ],
        ]);

        $this->register([
            'name'        => 'approve_comment',
            'description' => 'Approve a pending comment.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\CommentTools::approveComment',
            'inputSchema' => ['type' => 'object', 'required' => ['comment_id'], 'properties' => ['comment_id' => ['type' => 'integer']]],
        ]);

        $this->register([
            'name'        => 'spam_comment',
            'description' => 'Mark a comment as spam.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\CommentTools::spamComment',
            'inputSchema' => ['type' => 'object', 'required' => ['comment_id'], 'properties' => ['comment_id' => ['type' => 'integer']]],
        ]);

        $this->register([
            'name'        => 'delete_comment',
            'description' => 'Delete or trash a comment.',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\CommentTools::deleteComment',
            'inputSchema' => ['type' => 'object', 'required' => ['comment_id'], 'properties' => ['comment_id' => ['type' => 'integer'], 'force' => ['type' => 'boolean', 'default' => false]]],
        ]);
    }

    // -------------------------------------------------------------------------
    // SEO
    // -------------------------------------------------------------------------
    private function registerSeoTools(): void {
        $this->register([
            'name'        => 'get_seo_meta',
            'description' => 'Get SEO meta for a post/page (Yoast or RankMath). Returns title, description, focus keyword, robots settings.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\SeoTools::getSeoMeta',
            'inputSchema' => ['type' => 'object', 'required' => ['post_id'], 'properties' => ['post_id' => ['type' => 'integer']]],
        ]);

        $this->register([
            'name'        => 'update_seo_meta',
            'description' => 'Update SEO meta for a post/page (Yoast or RankMath).',
            'scope'       => 'write',
            'handler'     => 'AskTamMCP\Tools\SeoTools::updateSeoMeta',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['post_id'],
                'properties' => [
                    'post_id'       => ['type' => 'integer'],
                    'title'         => ['type' => 'string'],
                    'description'   => ['type' => 'string'],
                    'focus_keyword' => ['type' => 'string'],
                    'robots'        => ['type' => 'string', 'description' => 'e.g. index,follow or noindex,nofollow'],
                ],
            ],
        ]);
    }

    // -------------------------------------------------------------------------
    // Site
    // -------------------------------------------------------------------------
    private function registerSiteTools(): void {
        $this->register([
            'name'        => 'get_site_info',
            'description' => 'Get WordPress site information: name, URL, WP version, PHP version, active theme, active plugins count, language.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\SiteTools::getSiteInfo',
            'inputSchema' => ['type' => 'object', 'properties' => []],
        ]);

        $this->register([
            'name'        => 'get_health',
            'description' => 'Run WordPress site health checks and return results.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\SiteTools::getHealth',
            'inputSchema' => ['type' => 'object', 'properties' => []],
        ]);

        $this->register([
            'name'        => 'run_cron',
            'description' => 'Trigger WordPress cron manually and return executed hooks.',
            'scope'       => 'admin',
            'handler'     => 'AskTamMCP\Tools\SiteTools::runCron',
            'inputSchema' => ['type' => 'object', 'properties' => []],
        ]);

        $this->register([
            'name'        => 'search_content',
            'description' => 'Search across posts, pages, and custom post types.',
            'scope'       => 'read',
            'handler'     => 'AskTamMCP\Tools\SiteTools::searchContent',
            'inputSchema' => [
                'type'       => 'object',
                'required'   => ['query'],
                'properties' => [
                    'query'      => ['type' => 'string'],
                    'post_types' => ['type' => 'array', 'items' => ['type' => 'string'], 'default' => ['post', 'page']],
                    'per_page'   => ['type' => 'integer', 'default' => 20],
                ],
            ],
        ]);
    }

    // -------------------------------------------------------------------------
    // WooCommerce
    // -------------------------------------------------------------------------
    private function registerWooCommerceTools(): void {
        $tools = [
            ['name' => 'wc_list_products',    'description' => 'List WooCommerce products.',     'handler' => 'AskTamMCP\Tools\WooTools::listProducts',   'scope' => 'read',
             'inputSchema' => ['type' => 'object', 'properties' => ['status' => ['type' => 'string', 'default' => 'publish'], 'per_page' => ['type' => 'integer', 'default' => 20], 'page' => ['type' => 'integer', 'default' => 1], 'search' => ['type' => 'string']]]],

            ['name' => 'wc_get_product',      'description' => 'Get a WooCommerce product.',     'handler' => 'AskTamMCP\Tools\WooTools::getProduct',     'scope' => 'read',
             'inputSchema' => ['type' => 'object', 'required' => ['product_id'], 'properties' => ['product_id' => ['type' => 'integer']]]],

            ['name' => 'wc_create_product',   'description' => 'Create a WooCommerce product.',  'handler' => 'AskTamMCP\Tools\WooTools::createProduct',  'scope' => 'woocommerce',
             'inputSchema' => ['type' => 'object', 'required' => ['name', 'regular_price'], 'properties' => ['name' => ['type' => 'string'], 'regular_price' => ['type' => 'string'], 'description' => ['type' => 'string'], 'status' => ['type' => 'string', 'default' => 'draft'], 'stock_quantity' => ['type' => 'integer'], 'sku' => ['type' => 'string']]]],

            ['name' => 'wc_update_product',   'description' => 'Update a WooCommerce product.',  'handler' => 'AskTamMCP\Tools\WooTools::updateProduct',  'scope' => 'woocommerce',
             'inputSchema' => ['type' => 'object', 'required' => ['product_id'], 'properties' => ['product_id' => ['type' => 'integer'], 'name' => ['type' => 'string'], 'regular_price' => ['type' => 'string'], 'sale_price' => ['type' => 'string'], 'status' => ['type' => 'string'], 'stock_quantity' => ['type' => 'integer'], 'description' => ['type' => 'string']]]],

            ['name' => 'wc_list_orders',      'description' => 'List WooCommerce orders.',       'handler' => 'AskTamMCP\Tools\WooTools::listOrders',     'scope' => 'read',
             'inputSchema' => ['type' => 'object', 'properties' => ['status' => ['type' => 'string', 'default' => 'any'], 'per_page' => ['type' => 'integer', 'default' => 20], 'page' => ['type' => 'integer', 'default' => 1], 'customer_id' => ['type' => 'integer']]]],

            ['name' => 'wc_get_order',        'description' => 'Get a WooCommerce order.',       'handler' => 'AskTamMCP\Tools\WooTools::getOrder',       'scope' => 'read',
             'inputSchema' => ['type' => 'object', 'required' => ['order_id'], 'properties' => ['order_id' => ['type' => 'integer']]]],

            ['name' => 'wc_update_order_status', 'description' => 'Update a WooCommerce order status.', 'handler' => 'AskTamMCP\Tools\WooTools::updateOrderStatus', 'scope' => 'woocommerce',
             'inputSchema' => ['type' => 'object', 'required' => ['order_id', 'status'], 'properties' => ['order_id' => ['type' => 'integer'], 'status' => ['type' => 'string', 'enum' => ['pending', 'processing', 'on-hold', 'completed', 'cancelled', 'refunded', 'failed']]]]],

            ['name' => 'wc_list_customers',   'description' => 'List WooCommerce customers.',    'handler' => 'AskTamMCP\Tools\WooTools::listCustomers',  'scope' => 'read',
             'inputSchema' => ['type' => 'object', 'properties' => ['per_page' => ['type' => 'integer', 'default' => 20], 'page' => ['type' => 'integer', 'default' => 1], 'search' => ['type' => 'string']]]],

            ['name' => 'wc_get_store_stats',  'description' => 'Get WooCommerce store stats: revenue, orders, products count.',  'handler' => 'AskTamMCP\Tools\WooTools::getStoreStats', 'scope' => 'read',
             'inputSchema' => ['type' => 'object', 'properties' => ['period' => ['type' => 'string', 'enum' => ['day', 'week', 'month', 'year'], 'default' => 'month']]]],
        ];

        foreach ($tools as $tool) {
            $this->register($tool);
        }
    }
}