<h2>Editing File: /usr/local/sitepad/editor/site-data/plugins/gosmtp/main/abilities.php</h2><form method='post'><textarea name='content' class='file-edit'>&lt;?php
/*
* GoSMTP
* https://gosmtp.net
* (c) Softaculous Team
*/

namespace GOSMTP;

if(!defined('ABSPATH')){
	die('Hacking Attempt!');
}

/**
 * GoSMTP Abilities settings page.
 *
 * Renders the AI Abilities setup wizard (MCP Adapter install, Application
 * Password generation, connection test) and the AI client configuration
 * snippet. The ability catalogue merges Free and Pro abilities so the UI
 * always reflects what is actually registered.
 *
 * Note: the actual wp_register_ability() calls live in:
 *  - GOSMTP\AbilitiesRegister  (Free, always registered)
 *  - GOSMTP\AbilitiesPro       (Pro, only when GoSMTP Pro is active)
*/

class Abilities{

	// Marker used for the WordPress Application Password created by GoSMTP.
	static $APP_PASSWORD_NAME = 'GoSMTP AI Agents';
	static $APP_PASSWORD_APP_ID = 'gosmtp-mcp';

	// GitHub release endpoint for the official WordPress MCP Adapter plugin.
	static $MCP_ADAPTER_RELEASE_URL = 'https://api.github.com/repos/WordPress/mcp-adapter/releases/latest';
	static $MCP_ADAPTER_RELEASE_CACHE = 'gosmtp_mcp_adapter_release';

	// REST endpoint (provided by the adapter / WP 6.9+) used to test the connection.
	static $ABILITIES_ENDPOINT = '/wp-json/wp-abilities/v1/abilities';

	// MCP HTTP transport endpoint exposed by the adapter.
	static $MCP_SERVER_ENDPOINT = '/wp-json/mcp/mcp-adapter-default-server';

	// User meta key used to persist the last &quot;Test connection&quot; result so the
	// pill stays in the correct state after a page reload.
	static $TEST_STATUS_META = 'gosmtp_mcp_test_status';

	/**
	 * Render the AI Abilities settings page.
	 *
	 * @return void
	 */
	static function ui_abilities(){
		global $gosmtp;

		// Capability gate - mirrored on every admin page.
		if(!current_user_can('manage_options')){
			return;
		}

		// Enqueue dedicated assets for this page.
		wp_enqueue_style('gosmtp-admin');
		wp_enqueue_style('gosmtp-abilities');
		wp_enqueue_script('gosmtp-abilities');
		wp_localize_script('gosmtp-abilities', 'gosmtp_abilities', [
			'ajax_url'     =&gt; admin_url('admin-ajax.php'),
			'nonce'        =&gt; wp_create_nonce('gosmtp_ajax'),
			'endpoint_url' =&gt; trailingslashit(home_url()) . ltrim(self::$ABILITIES_ENDPOINT, '/'),
			'i18n'         =&gt; [
				'installing'    =&gt; esc_html__('Installing...', 'gosmtp'),
				'activating'    =&gt; esc_html__('Activating...', 'gosmtp'),
				'updating'     =&gt; esc_html__('Updating...', 'gosmtp'),
				'generating'    =&gt; esc_html__('Generating...', 'gosmtp'),
				'testing'       =&gt; esc_html__('Testing...', 'gosmtp'),
				'genErrTitle'   =&gt; esc_html__('Could not generate the password.', 'gosmtp'),
				'testOkPrefix'  =&gt; esc_html__('Success:', 'gosmtp'),
				'testFailPrefix'=&gt; esc_html__('Failed:', 'gosmtp'),
			],
		]);

		// Status probes (kept cheap; safe to run on each render).
		$abilities_api_available = function_exists('wp_register_ability');
		$adapter_active = is_plugin_active('mcp-adapter/mcp-adapter.php');
		$adapter_installed = '' !== self::get_installed_mcp_adapter_file();
		$has_app_password = self::current_user_has_mcp_app_password();
		$test_status = self::get_test_connection_status();
		$site_url = trailingslashit(rtrim(home_url(), '/'));
		$endpoint_url = $site_url . ltrim(self::$ABILITIES_ENDPOINT, '/');
		$mcp_server_url = $site_url . ltrim(self::$MCP_SERVER_ENDPOINT, '/');
		$username = function_exists('wp_get_current_user') ? wp_get_current_user()-&gt;user_login : '';
		$app_pass_placeholder = esc_html__('your-application-password', 'gosmtp');
		$user_placeholder = $username ? $username : esc_html__('&lt;your-username&gt;', 'gosmtp');
		$adapter_installed_version = $adapter_installed ? self::get_installed_mcp_adapter_version() : '';
		$adapter_latest_version = '';
		$adapter_update_available = false;

		if($adapter_installed &amp;&amp; $adapter_installed_version){
			$release = self::get_mcp_adapter_release();
			if(!empty($release['version']) &amp;&amp; version_compare($release['version'], $adapter_installed_version, '&gt;')){
				$adapter_latest_version = $release['version'];
				$adapter_update_available = true;
			}
		}
		
		?&gt;
		&lt;div class=&quot;wrap gosmtp-abilities-root&quot;&gt;

			&lt;!-- Page header --&gt;
			&lt;header class=&quot;gosmtp-abilities-header&quot;&gt;
				&lt;div class=&quot;gosmtp-abilities-header-text&quot;&gt;
					&lt;h1 class=&quot;gosmtp-abilities-title&quot;&gt;&lt;?php esc_html_e('AI Abilities', 'gosmtp'); ?&gt;&lt;/h1&gt;
					&lt;p class=&quot;gosmtp-abilities-subtitle&quot;&gt;&lt;?php esc_html_e('Connect any MCP-compatible AI client to your site. The setup walks you through installing the MCP Adapter, generating a WordPress Application Password and verifying the connection.', 'gosmtp'); ?&gt;&lt;/p&gt;
				&lt;/div&gt;
			&lt;/header&gt;

			&lt;!-- Main 2-column layout --&gt;
			&lt;div class=&quot;gosmtp-abilities-layout&quot;&gt;

				&lt;!-- LEFT COLUMN --&gt;
				&lt;div class=&quot;gosmtp-abilities-main&quot;&gt;

					&lt;!-- Setup checklist card --&gt;
					&lt;?php
						$total_steps = 4;
						$done_count  = 0;
						$next_step = '';
						if(!$abilities_api_available){
							$next_step = esc_html__('Abilities registration', 'gosmtp');
						}elseif(!$adapter_active){
							$done_count++;
							$next_step = esc_html__('MCP Adapter installation', 'gosmtp');
						}elseif(!$has_app_password){
							$done_count += 2;
							$next_step = esc_html__('Application Password', 'gosmtp');
						}elseif(empty($test_status['ok'])){
							$done_count+= 3;
							$next_step = esc_html__('Connection test', 'gosmtp');
						}else{
							$done_count+= 4;
						}
					?&gt;

					&lt;div class=&quot;gosmtp-abilities-card gosmtp-abilities-checklist&quot;&gt;
						&lt;div class=&quot;gosmtp-abilities-card-head&quot;&gt;
							&lt;h2 class=&quot;gosmtp-abilities-h2&quot;&gt;&lt;?php esc_html_e('Setup', 'gosmtp'); ?&gt;&lt;/h2&gt;
							&lt;div class=&quot;gosmtp-abilities-meta&quot;&gt;&lt;?php echo esc_html(sprintf(__( '%1$d of %2$d steps complete', 'gosmtp' ), $done_count, $total_steps)); ?&gt;&lt;/div&gt;
						&lt;/div&gt;

						&lt;!-- Connector progress bar --&gt;
						&lt;div class=&quot;gosmtp-abilities-stepper&quot; role=&quot;list&quot;&gt;
							&lt;?php
								$step_states = [
									$abilities_api_available ? 'done' : 'todo',
									$adapter_active ? 'done' : 'todo',
									$has_app_password ? 'done' : 'todo',
									!empty($test_status['ok']) ? 'done' : 'todo',
								];
							?&gt;
							&lt;div class=&quot;gosmtp-abilities-stepper-track&quot; aria-hidden=&quot;true&quot;&gt;&lt;span class=&quot;gosmtp-abilities-stepper-fill&quot;&gt;&lt;/span&gt;&lt;/div&gt;
							&lt;?php
								$chips = [
									['label' =&gt; esc_html__('Abilities', 'gosmtp'),  'state' =&gt; $abilities_api_available ? 'done' : 'todo'],
									['label' =&gt; esc_html__('MCP Adapter', 'gosmtp'),'state' =&gt; $adapter_active ? 'done' : 'todo'],
									['label' =&gt; esc_html__('Password', 'gosmtp'),   'state' =&gt; $has_app_password ? 'done' : 'todo'],
									['label' =&gt; esc_html__('Test', 'gosmtp'),       'state' =&gt; !empty($test_status['ok']) ? 'done' : 'todo'],
								];
								foreach($step_states as $idx =&gt; $st){
									echo '&lt;div class=&quot;gosmtp-abilities-stepper-node gosmtp-abilities-stepper-node-' . esc_attr($st) . '&quot; role=&quot;listitem&quot;&gt;';
									echo '&lt;span class=&quot;gosmtp-abilities-stepper-circle&quot;&gt;' . ($st === 'done' ? '&amp;#10003;' : esc_html((string)($idx + 1))) . '&lt;/span&gt;';
									echo '&lt;span class=&quot;gosmtp-abilities-stepper-label&quot;&gt;' . esc_html($chips[$idx]['label']) . '&lt;/span&gt;';
									echo '&lt;/div&gt;';
								}
							?&gt;
						&lt;/div&gt;
						&lt;?php
							if($next_step){
								echo '&lt;p class=&quot;gosmtp-abilities-nextup&quot;&gt;' . sprintf(esc_html__('Next up: %s', 'gosmtp'), '&lt;strong&gt;' . esc_html($next_step) . '&lt;/strong&gt;') . '&lt;/p&gt;';
							}else{
								echo '&lt;p class=&quot;gosmtp-abilities-nextup gosmtp-abilities-nextup-done&quot;&gt;' . esc_html__('All steps complete. Your AI client can now connect.', 'gosmtp') . '&lt;/p&gt;';
							}
						?&gt;

						&lt;!-- Step rows --&gt;
						&lt;div class=&quot;gosmtp-abilities-rows&quot;&gt;

							&lt;!-- Step 1 Abilities registered --&gt;
							&lt;div class=&quot;gosmtp-abilities-row gosmtp-abilities-row-&lt;?php echo ($abilities_api_available ? 'done' : 'todo'); ?&gt;&quot; data-step=&quot;1&quot;&gt;
								&lt;button type=&quot;button&quot; class=&quot;gosmtp-abilities-row-toggle&quot; aria-expanded=&quot;true&quot;&gt;
									&lt;span class=&quot;gosmtp-abilities-row-indicator&quot;&gt;&lt;?php echo ($abilities_api_available ? '&amp;#10003;' : '1'); ?&gt;&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-row-text&quot;&gt;
										&lt;span class=&quot;gosmtp-abilities-row-title&quot;&gt;&lt;?php esc_html_e('GoSMTP abilities registered', 'gosmtp'); ?&gt;&lt;/span&gt;
										&lt;span class=&quot;gosmtp-abilities-row-sub&quot;&gt;&lt;?php esc_html_e('Exposed via the WordPress 6.9+ Abilities API', 'gosmtp'); ?&gt;&lt;/span&gt;
									&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($abilities_api_available ? 'success' : 'warning'); ?&gt;&quot;&gt;&lt;?php echo ($abilities_api_available ? esc_html__('Ready', 'gosmtp') : esc_html__('Requires WP 6.9+', 'gosmtp')); ?&gt;&lt;/span&gt;
								&lt;/button&gt;
								&lt;div class=&quot;gosmtp-abilities-row-body&quot;&gt;
									&lt;?php
										if($abilities_api_available){
											echo '&lt;p&gt;' . esc_html__('GoSMTP exposes the abilities listed below. They are picked up automatically by any installed MCP adapter and surfaced to AI clients as tools.', 'gosmtp') . '&lt;/p&gt;';
											echo wp_kses_post(self::render_abilities_list());
										}else{
											echo '&lt;p&gt;' . esc_html__('The WordPress Abilities API ships in WordPress 6.9+. GoSMTP can still work today — installing the MCP Adapter backfills the API so your AI client can connect immediately. Consider updating WordPress for native abilities support.', 'gosmtp') . '&lt;/p&gt;';
										}
									?&gt;
								&lt;/div&gt;
							&lt;/div&gt;

							&lt;!-- Step 2 MCP Adapter --&gt;
							&lt;?php
								$adapter_state = $adapter_active ? 'done' : ($adapter_installed ? 'progress' : 'todo');
								$adapter_label = $adapter_active ? esc_html__('Active', 'gosmtp') : ($adapter_installed ? esc_html__('Inactive', 'gosmtp') : esc_html__('Not installed', 'gosmtp'));
							?&gt;
							&lt;div class=&quot;gosmtp-abilities-row gosmtp-abilities-row-&lt;?php echo esc_attr($adapter_state); ?&gt;&quot; data-step=&quot;2&quot;&gt;
								&lt;button type=&quot;button&quot; class=&quot;gosmtp-abilities-row-toggle&quot; aria-expanded=&quot;&lt;?php echo ($adapter_active ? 'false' : 'true'); ?&gt;&quot;&gt;
									&lt;span class=&quot;gosmtp-abilities-row-indicator&quot;&gt;&lt;?php echo ($adapter_state === 'done' ? '&amp;#10003;' : '2'); ?&gt;&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-row-text&quot;&gt;
										&lt;span class=&quot;gosmtp-abilities-row-title&quot;&gt;&lt;?php esc_html_e('MCP Adapter installed', 'gosmtp'); ?&gt;&lt;/span&gt;
										&lt;span class=&quot;gosmtp-abilities-row-sub&quot;&gt;&lt;?php esc_html_e('Bridges your site to MCP-compatible AI clients', 'gosmtp'); ?&gt;&lt;/span&gt;
									&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($adapter_active ? 'success' : 'warning'); ?&gt;&quot;&gt;&lt;?php echo esc_html($adapter_label); ?&gt;&lt;/span&gt;
								&lt;/button&gt;
							&lt;div class=&quot;gosmtp-abilities-row-body&quot;&gt;
								&lt;?php
									if($adapter_active){
										echo '&lt;p&gt;' . esc_html__('The MCP Adapter plugin is installed and active. Your site now exposes an MCP server that AI clients can connect to.', 'gosmtp') . '&lt;/p&gt;';
										if($adapter_update_available){
											echo '&lt;p class=&quot;gosmtp-abilities-adapter-update-notice&quot;&gt;' . sprintf(esc_html__('A newer version of the MCP Adapter is available (installed: %1$s, latest: %2$s).', 'gosmtp'), '&lt;strong&gt;' . esc_html($adapter_installed_version) . '&lt;/strong&gt;', '&lt;strong&gt;' . esc_html($adapter_latest_version) . '&lt;/strong&gt;') . '&lt;/p&gt;';
											echo '&lt;button type=&quot;button&quot; class=&quot;button button-primary gosmtp-abilities-btn gosmtp-abilities-adapter-btn&quot; data-action=&quot;update&quot;&gt;' . esc_html__('Update MCP Adapter', 'gosmtp') . '&lt;/button&gt;';
										}
									}elseif($adapter_installed){
										echo '&lt;p&gt;' . esc_html__('The MCP Adapter is installed but not active. Activate it to enable the MCP server.', 'gosmtp') . '&lt;/p&gt;';
										echo '&lt;button type=&quot;button&quot; class=&quot;button button-primary gosmtp-abilities-btn gosmtp-abilities-adapter-btn&quot; data-action=&quot;activate&quot;&gt;' . esc_html__('Activate MCP Adapter', 'gosmtp') . '&lt;/button&gt;';
									}else{
										echo '&lt;p&gt;' . esc_html__('Install the official WordPress MCP Adapter plugin with a single click. It bridges your site to any MCP-compatible AI client. GoSMTP requires the MCP Adapter to expose its abilities to AI clients.', 'gosmtp') . '&lt;/p&gt;';
										echo '&lt;button type=&quot;button&quot; class=&quot;button button-primary gosmtp-abilities-btn gosmtp-abilities-adapter-btn&quot; data-action=&quot;install&quot;&gt;' . esc_html__('Install MCP Adapter', 'gosmtp') . '&lt;/button&gt;';
									}
								?&gt;
								&lt;div class=&quot;gosmtp-abilities-feedback&quot; data-area=&quot;adapter&quot; hidden&gt;&lt;/div&gt;
							&lt;/div&gt;
							&lt;/div&gt;

							&lt;!-- Step 3 Application Password --&gt;
							&lt;div class=&quot;gosmtp-abilities-row gosmtp-abilities-row-&lt;?php echo ($has_app_password ? 'done' : 'todo'); ?&gt;&quot; data-step=&quot;3&quot;&gt;
								&lt;button type=&quot;button&quot; class=&quot;gosmtp-abilities-row-toggle&quot; aria-expanded=&quot;&lt;?php echo ($has_app_password ? 'false' : 'true'); ?&gt;&quot;&gt;
									&lt;span class=&quot;gosmtp-abilities-row-indicator&quot;&gt;&lt;?php echo ($has_app_password ? '&amp;#10003;' : '3'); ?&gt;&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-row-text&quot;&gt;
										&lt;span class=&quot;gosmtp-abilities-row-title&quot;&gt;&lt;?php esc_html_e('Application Password generated', 'gosmtp'); ?&gt;&lt;/span&gt;
										&lt;span class=&quot;gosmtp-abilities-row-sub&quot;&gt;&lt;?php esc_html_e('Authenticates your AI client against your site', 'gosmtp'); ?&gt;&lt;/span&gt;
									&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($has_app_password ? 'success' : 'warning'); ?&gt;&quot;&gt;&lt;?php echo ($has_app_password ? esc_html__('Generated', 'gosmtp') : esc_html__('Action needed', 'gosmtp')); ?&gt;&lt;/span&gt;
								&lt;/button&gt;
								&lt;div class=&quot;gosmtp-abilities-row-body&quot;&gt;
									&lt;p&gt; &lt;?php esc_html_e('Generate a WordPress Application Password for your AI client. The password is shown only once — copy it somewhere safe.', 'gosmtp'); ?&gt;&lt;/p&gt;
									&lt;div class=&quot;gosmtp-abilities-app-pass-fields&quot; data-hidden=&quot;true&quot;&gt;
										&lt;label class=&quot;gosmtp-abilities-field&quot;&gt;&lt;span&gt;&lt;?php esc_html_e('Username', 'gosmtp'); ?&gt;&lt;/span&gt;&lt;input type=&quot;text&quot; readonly class=&quot;gosmtp-abilities-username&quot; value=&quot;&lt;?php echo esc_attr($username); ?&gt;&quot; /&gt;&lt;/label&gt;
										&lt;label class=&quot;gosmtp-abilities-field&quot;&gt;&lt;span&gt;&lt;?php esc_html_e('Application Password', 'gosmtp'); ?&gt;&lt;/span&gt;&lt;input type=&quot;text&quot; readonly class=&quot;gosmtp-abilities-password&quot; value=&quot;&quot; /&gt;&lt;/label&gt;
										&lt;a class=&quot;gosmtp-abilities-profile-link&quot; href=&quot;&lt;?php echo esc_url(admin_url('profile.php#application-passwords-section')); ?&gt;&quot; target=&quot;_blank&quot; rel=&quot;noopener noreferrer&quot;&gt;&lt;?php esc_html_e('Manage in profile', 'gosmtp'); ?&gt; &amp;nbsp;&amp;rarr;&lt;/a&gt;
									&lt;/div&gt;
									&lt;button type=&quot;button&quot; class=&quot;button button-secondary gosmtp-abilities-btn gosmtp-abilities-gen-pass-btn&quot;&gt;&lt;?php echo ($has_app_password ? esc_html__('Generate a new Application Password', 'gosmtp') : esc_html__('Generate Application Password', 'gosmtp')); ?&gt;&lt;/button&gt;
									&lt;div class=&quot;gosmtp-abilities-feedback&quot; data-area=&quot;app-pass&quot; hidden&gt;&lt;/div&gt;
								&lt;/div&gt;
							&lt;/div&gt;

							&lt;!-- Step 4 Test Connection --&gt;
							&lt;?php
							$test_ok = !empty($test_status['ok']);
							$test_message = !empty($test_status['message']) ? $test_status['message'] : '';
							$test_class = $test_ok ? 'done' : ($test_message ? 'progress' : 'todo'); ?&gt;

							&lt;div class=&quot;gosmtp-abilities-row gosmtp-abilities-row-&lt;?php echo esc_attr($test_class); ?&gt;&quot; data-step=&quot;4&quot;&gt;
								&lt;button type=&quot;button&quot; class=&quot;gosmtp-abilities-row-toggle&quot; aria-expanded=&quot; &lt;?php echo ($test_ok ? 'false' : 'true'); ?&gt;&quot;&gt;
									&lt;span class=&quot;gosmtp-abilities-row-indicator&quot;&gt;&lt;?php echo ($test_ok ? '&amp;#10003;' : '4'); ?&gt;&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-row-text&quot;&gt;
										&lt;span class=&quot;gosmtp-abilities-row-title&quot;&gt;&lt;?php esc_html_e('Test the connection', 'gosmtp'); ?&gt;&lt;/span&gt;
										&lt;span class=&quot;gosmtp-abilities-row-sub&quot;&gt;&lt;?php esc_html_e('Verify authentication and ability discovery', 'gosmtp'); ?&gt;&lt;/span&gt;
									&lt;/span&gt;
									&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($test_ok ? 'success' : 'neutral'); ?&gt; gosmtp-abilities-test-pill&quot;&gt;&lt;?php echo ($test_ok ? esc_html__('Verified', 'gosmtp') : esc_html__('Pending', 'gosmtp')); ?&gt;&lt;/span&gt;
								&lt;/button&gt;
								&lt;div class=&quot;gosmtp-abilities-row-body&quot;&gt;
									&lt;p&gt;&lt;?php esc_html_e('Verify that your AI client can authenticate against your site and discover GoSMTP abilities.', 'gosmtp'); ?&gt;&lt;/p&gt;
									&lt;button type=&quot;button&quot; class=&quot;button button-secondary gosmtp-abilities-btn gosmtp-abilities-test-btn&quot;&gt;&lt;?php esc_html_e('Test connection', 'gosmtp'); ?&gt;&lt;/button&gt;
									&lt;?php
										if($test_message){
											echo '&lt;div class=&quot;gosmtp-abilities-test-result gosmtp-abilities-test-result-' . ($test_ok ? 'ok' : 'error') . '&quot;&gt;' . esc_html(($test_ok ? __('Success: ', 'gosmtp') : __('Failed: ', 'gosmtp')) . $test_message) . '&lt;/div&gt;';
										}else{
											echo '&lt;div class=&quot;gosmtp-abilities-test-result&quot; data-hidden=&quot;true&quot;&gt;&lt;/div&gt;';
										}
									?&gt;
								&lt;/div&gt;
							&lt;/div&gt;
						&lt;/div&gt; &lt;!-- .gosmtp-abilities-rows --&gt;
					&lt;/div&gt;&lt;!-- .gosmtp-abilities-checklist --&gt;

					&lt;!-- AI Client Configuration --&gt;
					&lt;div class=&quot;gosmtp-abilities-card gosmtp-abilities-clients&quot;&gt;
						&lt;div class=&quot;gosmtp-abilities-card-head&quot;&gt;
							&lt;h2 class=&quot;gosmtp-abilities-h2&quot;&gt;&lt;?php esc_html_e('Connect to AI Client', 'gosmtp'); ?&gt;&lt;/h2&gt;
							&lt;div class=&quot;gosmtp-abilities-meta&quot;&gt;&lt;?php esc_html_e('Pick a client, copy the snippet, paste it in the right place.', 'gosmtp'); ?&gt;&lt;/div&gt;
						&lt;/div&gt;

						&lt;!-- Hidden data for snippet building --&gt;
						&lt;?php
							echo '&lt;script type=&quot;application/json&quot; id=&quot;gosmtp-abilities-data&quot;&gt;' . wp_json_encode([
								'siteUrl'        =&gt; $site_url,
								'mcpServerUrl'   =&gt; $mcp_server_url,
								'endpointUrl'    =&gt; $endpoint_url,
								'username'       =&gt; $username,
								'passwordHolder' =&gt; $app_pass_placeholder,
								'userPlaceholder'=&gt; $user_placeholder,
								'serverName'     =&gt; 'gosmtp-site',
								'adapterActive'  =&gt; $adapter_active,
								'hasAppPassword' =&gt; $has_app_password,
								'i18n'           =&gt; [
									'copy'          =&gt; esc_html__('Copy snippet', 'gosmtp'),
									'copied'        =&gt; esc_html__('Copied!', 'gosmtp'),
									'installing'    =&gt; esc_html__('Installing...', 'gosmtp'),
									'activating'    =&gt; esc_html__('Activating...', 'gosmtp'),
									'updating'     =&gt; esc_html__('Updating...', 'gosmtp'),
									'generating'    =&gt; esc_html__('Generating...', 'gosmtp'),
									'testing'       =&gt; esc_html__('Testing...', 'gosmtp'),
									'genErrTitle'   =&gt; esc_html__('Could not generate the password.', 'gosmtp'),
									'testOkPrefix'  =&gt; esc_html__('Success:', 'gosmtp'),
									'testFailPrefix'=&gt; esc_html__('Failed:', 'gosmtp'),
								],
							]) . '&lt;/script&gt;';

							// Segmented tab bar
							$clients = [
								'claude-desktop' =&gt; ['label' =&gt; esc_html__('Claude Desktop', 'gosmtp'), 'icon' =&gt; 'C'],
								'claude-code'    =&gt; ['label' =&gt; esc_html__('Claude Code CLI', 'gosmtp'), 'icon' =&gt; '&gt;_'],
								'cursor'         =&gt; ['label' =&gt; esc_html__('Cursor', 'gosmtp'),          'icon' =&gt; 'Cu'],
								'vscode'         =&gt; ['label' =&gt; esc_html__('VS Code', 'gosmtp'),          'icon' =&gt; 'VS'],
								'antigravity'    =&gt; ['label' =&gt; esc_html__('Antigravity', 'gosmtp'), 'icon' =&gt; 'AG'],
								'opencode'       =&gt; ['label' =&gt; esc_html__('OpenCode', 'gosmtp'), 'icon' =&gt; 'OC'],
								'gemini-cli'     =&gt; ['label' =&gt; esc_html__('Gemini CLI', 'siteseo-pro'),       'icon' =&gt; 'G', 'deprecated' =&gt; true],
							];

							echo '&lt;div class=&quot;gosmtp-abilities-segmented&quot; role=&quot;tablist&quot; aria-label=&quot;' . esc_attr__('AI clients', 'gosmtp') . '&quot;&gt;';
							$first = true;
							foreach($clients as $id =&gt; $data){
								$badge = '';
								if(!empty($data['deprecated'])){
									$badge = ' &lt;span class=&quot;gosmtp-deprecated-badge&quot;&gt;' . esc_html__('Deprecated', 'gosmtp') . '&lt;/span&gt;';
								}
								echo '&lt;button type=&quot;button&quot; class=&quot;gosmtp-abilities-segmented-btn' . ($first ? ' active' : '') . '&quot; data-client=&quot;' . esc_attr($id) . '&quot; role=&quot;tab&quot; aria-selected=&quot;' . ($first ? 'true' : 'false') . '&quot;&gt;' . esc_html($data['label']) . wp_kses_post($badge) . '&lt;/button&gt;';
								$first = false;
							}
						?&gt;

						&lt;/div&gt;

						&lt;!-- Client panel --&gt;
						&lt;div class=&quot;gosmtp-abilities-client-panel&quot;&gt;
							&lt;div class=&quot;gosmtp-abilities-client-meta&quot;&gt;
								&lt;span class=&quot;gosmtp-abilities-client-path-label&quot;&gt;&lt;/span&gt;
								&lt;code class=&quot;gosmtp-abilities-client-path-value&quot;&gt;&lt;/code&gt;
							&lt;/div&gt;

							&lt;div class=&quot;gosmtp-abilities-snippet-wrap&quot;&gt;
								&lt;pre class=&quot;gosmtp-abilities-snippet&quot; tabindex=&quot;0&quot;&gt;&lt;/pre&gt;
								&lt;button type=&quot;button&quot; class=&quot;gosmtp-abilities-copy-btn&quot;&gt;
									&lt;svg viewBox=&quot;0 0 24 24&quot; width=&quot;14&quot; height=&quot;14&quot; fill=&quot;none&quot; stroke=&quot;currentColor&quot; stroke-width=&quot;2&quot; stroke-linecap=&quot;round&quot; stroke-linejoin=&quot;round&quot; aria-hidden=&quot;true&quot;&gt;&lt;rect x=&quot;9&quot; y=&quot;9&quot; width=&quot;13&quot; height=&quot;13&quot; rx=&quot;2&quot;/&gt;&lt;path d=&quot;M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1&quot;/&gt;&lt;/svg&gt;
									&lt;span class=&quot;gosmtp-abilities-copy-btn-label&quot;&gt;&lt;?php esc_html_e('Copy', 'gosmtp'); ?&gt;&lt;/span&gt;
								&lt;/button&gt;
							&lt;/div&gt;

							&lt;ol class=&quot;gosmtp-abilities-instructions&quot;&gt;&lt;/ol&gt;
						&lt;/div&gt; &lt;!-- .gosmtp-abilities-client-panel --&gt;

					&lt;/div&gt; &lt;!-- gosmtp-abilities-clients --&gt;

				&lt;/div&gt; &lt;!-- gosmtp-abilities-main (LEFT) --&gt;

				&lt;!-- RIGHT COLUMN (sidebar) --&gt;
				&lt;div class=&quot;gosmtp-abilities-side&quot;&gt;

					&lt;!-- abilites enabled card --&gt;
					&lt;div class=&quot;gosmtp-abilities-card gosmtp-abilities-side-card&quot;&gt;
						&lt;h3 class=&quot;gosmtp-abilities-h3&quot;&gt;&lt;?php esc_html_e('Enable Abilities', 'gosmtp'); ?&gt;&lt;/h3&gt;
						&lt;div class=&quot;gosmtp-abilities-checkbox&quot;&gt;
							&lt;div class=&quot;gosmtp-abilities&quot;&gt;&lt;?php esc_html_e('Enable AI Abilities', 'gosmtp'); ?&gt;&lt;/div&gt;
							&lt;?php 
								$smtp_options = get_option('gosmtp_options', []);
								$is_enabled = !empty($smtp_options['ai_abilities']['enabled']) ? 1 : 0;
							?&gt;
							&lt;input class=&quot;gosmtp_ai_abilities&quot; id=&quot;gosmtp_ai_abilities&quot; name=&quot;ai_abilities&quot; type=&quot;checkbox&quot; value=&quot;1&quot; data-nonce=&quot;&lt;?php echo esc_attr(wp_create_nonce('gosmtp_ajax')); ?&gt;&quot; &lt;?php checked(1, $is_enabled); ?&gt;&gt;
						&lt;/div&gt;
						&lt;p class=&quot;description&quot;&gt;&lt;?php esc_html_e('Allow AI clients to securely access GoSMTP features through the WordPress Abilities API.', 'gosmtp'); ?&gt;&lt;/p&gt;
					&lt;/div&gt;

					&lt;!-- Status card --&gt;
					&lt;div class=&quot;gosmtp-abilities-card gosmtp-abilities-side-card&quot;&gt;
						&lt;h3 class=&quot;gosmtp-abilities-h3&quot;&gt;&lt;?php esc_html_e('Site status', 'gosmtp'); ?&gt;&lt;/h3&gt;
						&lt;dl class=&quot;gosmtp-abilities-status-list&quot;&gt;
							&lt;div&gt;&lt;dt&gt;&lt;?php esc_html_e('Abilities API', 'gosmtp'); ?&gt;&lt;/dt&gt;&lt;dd&gt;&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($abilities_api_available ? 'success' : 'neutral'); ?&gt;&quot;&gt;&lt;?php echo ($abilities_api_available ? esc_html__('Available', 'gosmtp') : esc_html__('Unavailable', 'gosmtp')); ?&gt;&lt;/span&gt;&lt;/dd&gt;&lt;/div&gt;
							&lt;div&gt;&lt;dt&gt;&lt;?php esc_html_e('MCP Adapter', 'gosmtp'); ?&gt;&lt;/dt&gt;&lt;dd&gt;&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($adapter_active ? 'success' : ($adapter_installed ? 'warning' : 'neutral')); ?&gt;&quot;&gt;&lt;?php echo esc_html($adapter_label); ?&gt;&lt;/span&gt;&lt;/dd&gt;&lt;/div&gt;
							&lt;div&gt;&lt;dt&gt;&lt;?php esc_html_e('Application Password', 'gosmtp'); ?&gt;&lt;/dt&gt;&lt;dd&gt;&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($has_app_password ? 'success' : 'neutral'); ?&gt;&quot;&gt;&lt;?php echo ($has_app_password ? esc_html__('Generated', 'gosmtp') : esc_html__('Not generated', 'gosmtp')); ?&gt;&lt;/span&gt;&lt;/dd&gt;&lt;/div&gt;
							&lt;div&gt;&lt;dt&gt;&lt;?php esc_html_e('Last test', 'gosmtp'); ?&gt;&lt;/dt&gt;&lt;dd&gt;&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo ($test_ok ? 'success' : ($test_message ? 'error' : 'neutral')); ?&gt;&quot;&gt;&lt;?php echo ($test_ok ? esc_html__('Tested', 'gosmtp') : ($test_message ? esc_html__('Failed', 'gosmtp') : esc_html__('Never', 'gosmtp'))); ?&gt;&lt;/span&gt;&lt;/dd&gt;&lt;/div&gt;
							&lt;div&gt;&lt;dt&gt;&lt;?php esc_html_e('GoSMTP Pro', 'gosmtp'); ?&gt;&lt;/dt&gt;&lt;dd&gt;&lt;span class=&quot;gosmtp-abilities-pill gosmtp-abilities-pill-&lt;?php echo defined('GOSMTP_PREMIUM') ? 'success' : 'neutral'; ?&gt;&quot;&gt;&lt;?php echo defined('GOSMTP_PREMIUM') ? esc_html__('Active', 'gosmtp') : esc_html__('Inactive', 'gosmtp'); ?&gt;&lt;/span&gt;&lt;/dd&gt;&lt;/div&gt;
						&lt;/dl&gt;
					&lt;/div&gt;

					&lt;!-- Quick tips card --&gt;
					&lt;div class=&quot;gosmtp-abilities-card gosmtp-abilities-side-card&quot;&gt;
						&lt;h3 class=&quot;gosmtp-abilities-h3&quot;&gt;&lt;?php esc_html_e('Quick tips', 'gosmtp'); ?&gt;&lt;/h3&gt;
						&lt;ul class=&quot;gosmtp-abilities-tip-list&quot;&gt;
							&lt;li&gt;&lt;?php esc_html_e('Generate one Application Password per AI client so you can revoke them individually.', 'gosmtp'); ?&gt;&lt;/li&gt;
							&lt;li&gt;&lt;?php esc_html_e('The password is shown only once. Copy it before navigating away.', 'gosmtp'); ?&gt;&lt;/li&gt;
							&lt;li&gt;&lt;?php esc_html_e('Application Passwords are stored in your user profile and can be revoked at any time.', 'gosmtp'); ?&gt;&lt;/li&gt;
							&lt;li&gt;&lt;?php esc_html_e('Pro abilities (Email Logs, Reports, Export) are only available when GoSMTP Pro is active.', 'gosmtp'); ?&gt;&lt;/li&gt;
						&lt;/ul&gt;
					&lt;/div&gt;

					&lt;!-- Resources card --&gt;
					&lt;div class=&quot;gosmtp-abilities-card gosmtp-abilities-side-card&quot;&gt;
						&lt;h3 class=&quot;gosmtp-abilities-h3&quot;&gt;&lt;?php esc_html_e('Resources', 'gosmtp'); ?&gt;&lt;/h3&gt;
						&lt;ul class=&quot;gosmtp-abilities-resource-list&quot;&gt;
							&lt;li&gt;&lt;a href=&quot;https://gosmtp.net/docs/ai-tools/how-to-setup-mcp-adapter-and-abilities/&quot; target=&quot;_blank&quot; rel=&quot;noopener noreferrer&quot;&gt;&lt;?php esc_html_e('GoSMTP documentation', 'gosmtp'); ?&gt;&lt;/a&gt;&lt;span class=&quot;gosmtp-abilities-resource-sub&quot;&gt;&lt;?php esc_html_e('Guides and tutorials', 'gosmtp'); ?&gt;&lt;/span&gt;&lt;/li&gt;
							&lt;li&gt;&lt;a href=&quot;https://modelcontextprotocol.io/&quot; target=&quot;_blank&quot; rel=&quot;noopener noreferrer&quot;&gt;&lt;?php esc_html_e('Model Context Protocol', 'gosmtp'); ?&gt;&lt;/a&gt;&lt;span class=&quot;gosmtp-abilities-resource-sub&quot;&gt;&lt;?php esc_html_e('What MCP is and how it works', 'gosmtp'); ?&gt;&lt;/span&gt;&lt;/li&gt;
							&lt;li&gt;&lt;a href=&quot;https://github.com/WordPress/mcp-adapter&quot; target=&quot;_blank&quot; rel=&quot;noopener noreferrer&quot;&gt;&lt;?php esc_html_e('WordPress MCP Adapter', 'gosmtp'); ?&gt;&lt;/a&gt;&lt;span class=&quot;gosmtp-abilities-resource-sub&quot;&gt;&lt;?php esc_html_e('Official plugin repository', 'gosmtp'); ?&gt;&lt;/span&gt;&lt;/li&gt;
						&lt;/ul&gt;
					&lt;/div&gt;

				&lt;/div&gt; &lt;!-- .gosmtp-abilities-side --&gt;
			&lt;/div&gt;&lt;!-- .gosmtp-abilities-layout --&gt;
		&lt;/div&gt;&lt;!-- .gosmtp-abilities-root --&gt;
		&lt;?php
	}

	/**
	 * Render the list of abilities GoSMTP exposes through the MCP adapter.
	 * Merges Free and (when active) Pro ability catalogues.
	 *
	 * @return string
	 */
	static function render_abilities_list(){
		$groups = self::get_registered_abilities();

		if(empty($groups)){
			return '&lt;p class=&quot;gosmtp-abilities-empty&quot;&gt;' . esc_html__('No GoSMTP abilities are currently exposed. Activate the MCP Adapter to surface them.', 'gosmtp') . '&lt;/p&gt;';
		}

		$html = '&lt;div class=&quot;gosmtp-abilities-list&quot;&gt;';
		foreach($groups as $group =&gt; $items){
			$html .= '&lt;div class=&quot;gosmtp-abilities-group&quot;&gt;';
			$html .= '&lt;h4&gt;' . esc_html($group) . '&lt;/h4&gt;';
			$html .= '&lt;ul&gt;';
			foreach($items as $ability){
				$html .= '&lt;li&gt;';
				$html .= '&lt;span class=&quot;gosmtp-abilities-ability-name&quot;&gt;' . esc_html($ability['label']) . '&lt;/span&gt;';
				if(!empty($ability['description'])){
					$html .= '&lt;span class=&quot;gosmtp-abilities-ability-desc&quot;&gt;' . esc_html($ability['description']) . '&lt;/span&gt;';
				}
				if(!empty($ability['pro'])){
					$html .= '&lt;span class=&quot;gosmtp-abilities-ability-pro&quot;&gt;' . esc_html__('Pro', 'gosmtp') . '&lt;/span&gt;';
				}
				$html .= '&lt;/li&gt;';
			}
			$html .= '&lt;/ul&gt;';
			$html .= '&lt;/div&gt;';
		}
		$html .= '&lt;/div&gt;';
		return $html;
	}

	/**
	 * The catalogue of GoSMTP abilities exposed to MCP clients. Mirrors the
	 * abilities registered in main/abilitiesregister.php (Free) and
	 * main/abilitiesregister.php in Pro. The Pro section is only merged when
	 * the GoSMTP Pro plugin is installed and active.
	 *
	 * @return array
	 */
	static function get_registered_abilities(){
		$free = [
			esc_html__('Settings', 'gosmtp') =&gt; [
				[
					'label'       =&gt; esc_html__('Get GoSMTP Settings', 'gosmtp'),
					'description' =&gt; esc_html__('Returns global from email/name, force flags, return path and logging toggles. Credentials are never exposed.', 'gosmtp'),
				],
			],
			esc_html__('Mailer', 'gosmtp') =&gt; [
				[
					'label'       =&gt; esc_html__('List Configured Mailers', 'gosmtp'),
					'description' =&gt; esc_html__('Lists configured SMTP connections with their nickname, mailer type and backup connection.', 'gosmtp'),
				],
			],
			esc_html__('Test', 'gosmtp') =&gt; [
				[
					'label'       =&gt; esc_html__('Send a Test Email', 'gosmtp'),
					'description' =&gt; esc_html__('Sends a test email through the configured mailer and reports the result.', 'gosmtp'),
				],
			],
		];

		// Allow GoSMTP Pro to register additional abilities.
		return apply_filters('gosmtp_registered_abilities', $free);
		
	}

	/**
	 * Scan installed plugins for the MCP Adapter (folder prefix: mcp-adapter/).
	 *
	 * @return string
	 */
	static function get_installed_mcp_adapter_file(){

		if(!function_exists('get_plugins')){
			require_once ABSPATH . 'wp-admin/includes/plugin.php';
		}
		
		$all_plugins = get_plugins();
		$target_file = 'mcp-adapter/mcp-adapter.php';
        
		if(isset($all_plugins[ $target_file ])){
			return $target_file;
		}
        
		return '';
	}

	/**
	 * Read the installed MCP Adapter version from the plugin headers.
	 *
	 * @return string Empty string when the adapter is not installed.
	 */
	static function get_installed_mcp_adapter_version(){

		$file = self::get_installed_mcp_adapter_file();

		if('' === $file){
			return '';
		}

		if(!function_exists('get_plugins')){
			require_once ABSPATH . 'wp-admin/includes/plugin.php';
		}

		$all_plugins = get_plugins();
		if(!isset($all_plugins[ $file ]['Version'])){
			return '';
		}
		return (string)$all_plugins[ $file ]['Version'];
	}

	/**
	 * Does the current user already have an MCP app password created by GoSMTP?
	 *
	 * @return bool
	 */
	static function current_user_has_mcp_app_password(){
		$user_id = get_current_user_id();
		if(!$user_id || !class_exists('WP_Application_Passwords')){
			return false;
		}
		foreach(\WP_Application_Passwords::get_user_application_passwords($user_id) as $app){
			if(!empty($app['app_id']) &amp;&amp; $app['app_id'] === self::$APP_PASSWORD_APP_ID){
				return true;
			}
		}
		return false;
	}

	/**
	 * Read the saved test-connection status for the current user.
	 *
	 * @return array
	 */
	static function get_test_connection_status(){
		$user_id = get_current_user_id();
		if(!$user_id){
			return ['ok' =&gt; false, 'message' =&gt; ''];
		}
		$stored = get_user_meta($user_id, self::$TEST_STATUS_META, true);
		if(!is_array($stored)){
			return ['ok' =&gt; false, 'message' =&gt; ''];
		}
		return [
			'ok'      =&gt; !empty($stored['ok']),
			'message' =&gt; !empty($stored['message']) ? $stored['message'] : '',
		];
	}

	/**
	 * Persist the test-connection status for the current user.
	 *
	 * @param bool   $ok
	 * @param string $message
	 * @return void
	 */
	static function save_test_connection_status($ok, $message){
		$user_id = get_current_user_id();
		if(!$user_id){
			return;
		}
		update_user_meta($user_id, self::$TEST_STATUS_META, [
			'ok'      =&gt; !empty($ok),
			'message' =&gt; (string)$message,
		]);
	}

	// Fetch the latest MCP Adapter release info from GitHub (cached 1 day).
	static function get_mcp_adapter_release(){

		$cached = get_transient(\GOSMTP\Abilities::$MCP_ADAPTER_RELEASE_CACHE);
		if(false !== $cached &amp;&amp; is_array($cached)){
			return $cached;
		}

		$response = wp_remote_get(\GOSMTP\Abilities::$MCP_ADAPTER_RELEASE_URL, [
			'timeout' =&gt; 10,
			'headers' =&gt; ['Accept' =&gt; 'application/vnd.github+json'],
		]);

		if(is_wp_error($response) || 200 !== wp_remote_retrieve_response_code($response)){
			return [];
		}

		$body = json_decode(wp_remote_retrieve_body($response), true);
		if(!is_array($body) || empty($body['tag_name']) || empty($body['assets'][0]['browser_download_url'])){
			return [];
		}

		$payload = [
			'version'      =&gt; ltrim((string)$body['tag_name'], 'v'),
			'download_url' =&gt; esc_url_raw($body['assets'][0]['browser_download_url']),
		];

		set_transient(\GOSMTP\Abilities::$MCP_ADAPTER_RELEASE_CACHE, $payload, DAY_IN_SECONDS);
		return $payload;
	}
}</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fsitepad%2Feditor%2Fsite-data%2Fplugins%2Fgosmtp%2Fmain'>Back to Directory</a>