• File: manage-experiments-ability.php
  • Full Path: /home/slvgwrnz/public_html/wp-content/plugins/elementor/modules/mcp/abilities/manage-experiments-ability.php
  • Date Modified: 11/05/2026 9:17 AM
  • File size: 5.45 KB
  • MIME-type: text/x-php
  • Charset: utf-8
<?php

namespace Elementor\Modules\Mcp\Abilities;

use Elementor\Core\Experiments\Exceptions\Dependency_Exception;
use Elementor\Core\Experiments\Manager as Experiments_Manager;
use Elementor\Modules\AtomicWidgets\OptIn\Opt_In;
use Elementor\Modules\Mcp\Abilities\Utils\Experiments_Catalog;
use Elementor\Modules\Mcp\Abilities\Utils\Prompt_Loader;
use Elementor\Plugin;

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

class Manage_Experiments_Ability extends Abstract_Ability {

	const ACTION_ACTIVATE = 'activate';
	const ACTION_DEACTIVATE = 'deactivate';
	const ACTION_RESET = 'reset';
	const ACTION_ENABLE_ATOMIC_EDITOR = 'enable_atomic_editor';
	const ACTION_DISABLE_ATOMIC_EDITOR = 'disable_atomic_editor';

	protected function get_ability_id(): string {
		return 'elementor/manage-experiments';
	}

	public function is_exposed_via_proxy(): bool {
		return false;
	}

	protected function get_definition(): Ability_Definition {
		return new Ability_Definition(
			__( 'Manage Elementor Experiments', 'elementor' ),
			Prompt_Loader::load( 'manage-experiments' ),
			'elementor',
			[
				'type' => 'object',
				'properties' => [
					'success' => [ 'type' => 'boolean' ],
					'experiment' => Experiments_Catalog::experiment_schema(),
					'atomic_editor' => Experiments_Catalog::atomic_editor_schema(),
					'llm_instructions' => [
						'type' => 'string',
						'description' => 'Mandatory next step: follow this text and include it in your reply to the user.',
					],
				],
			],
			[
				'annotations' => [
					'readonly' => false,
					'idempotent' => true,
					'destructive' => true,
				],
				'mutates_page' => false,
			],
			fn() => current_user_can( 'manage_options' ),
			[
				'type' => 'object',
				'required' => [ 'action' ],
				'properties' => [
					'action' => [
						'type' => 'string',
						'enum' => array_keys( $this->get_action_handlers() ),
						'description' => 'activate / deactivate / reset (back to default) change one experiment and need "name". enable_atomic_editor / disable_atomic_editor turn the Atomic Editor (V4) on or off.',
					],
					'name' => [
						'type' => 'string',
						'description' => 'Experiment name from list-experiments. Required for activate, deactivate and reset.',
					],
				],
			]
		);
	}

	public function execute( $input = [] ) {
		$input = is_array( $input ) ? $input : [];
		$action = isset( $input['action'] ) && is_string( $input['action'] ) ? $input['action'] : '';
		$name = isset( $input['name'] ) && is_string( $input['name'] ) ? sanitize_key( $input['name'] ) : '';
		$handler = $this->get_action_handlers()[ $action ] ?? null;

		if ( ! $handler ) {
			return $this->error( 'invalid_input', __( 'A valid action is required.', 'elementor' ), \WP_Http::BAD_REQUEST );
		}

		try {
			return $handler( $name );
		} catch ( Dependency_Exception $e ) {
			return $this->error( 'experiment_dependency_inactive', $e->getMessage(), \WP_Http::CONFLICT );
		}
	}

	private function get_action_handlers(): array {
		return [
			self::ACTION_ACTIVATE => fn( string $name ) => $this->change_experiment( $name, Experiments_Manager::STATE_ACTIVE ),
			self::ACTION_DEACTIVATE => fn( string $name ) => $this->change_experiment( $name, Experiments_Manager::STATE_INACTIVE ),
			self::ACTION_RESET => fn( string $name ) => $this->change_experiment( $name, Experiments_Manager::STATE_DEFAULT ),
			self::ACTION_ENABLE_ATOMIC_EDITOR => fn() => $this->enable_atomic_editor(),
			self::ACTION_DISABLE_ATOMIC_EDITOR => fn() => $this->disable_atomic_editor(),
		];
	}

	private function change_experiment( string $name, string $state ) {
		if ( '' === $name ) {
			return $this->error( 'invalid_input', __( 'The name of the experiment is required.', 'elementor' ), \WP_Http::BAD_REQUEST );
		}

		$feature = Experiments_Catalog::find( $name );

		if ( ! $feature ) {
			return $this->error( 'experiment_not_found', __( 'Experiment not found. Use list-experiments to see the available names.', 'elementor' ), \WP_Http::NOT_FOUND );
		}

		if ( ! Experiments_Catalog::is_toggleable( $feature ) ) {
			return $this->error( 'experiment_not_toggleable', __( 'This experiment can not be changed from here.', 'elementor' ), \WP_Http::BAD_REQUEST );
		}

		Plugin::$instance->experiments->set_feature_state( $name, $state );

		$response = [
			'success' => true,
			'experiment' => Experiments_Catalog::format( Experiments_Catalog::find( $name ) ),
		];

		$warning = $response['experiment']['deactivation_warning'];

		if ( Experiments_Manager::STATE_INACTIVE === $state && null !== $warning ) {
			$response['llm_instructions'] = $warning;
		}

		return $response;
	}

	private function enable_atomic_editor(): array {
		$was_active = Experiments_Catalog::atomic_editor_status()['active'];

		( new Opt_In() )->opt_in_v4();

		$instructions = $was_active
			? __( 'The Atomic Editor was already on. Nothing else to do.', 'elementor' )
			: __( 'The Atomic Editor is now on. Refresh your tool list to use the V4 tools. Editor tabs the user already has open must be reloaded.', 'elementor' );

		return $this->atomic_editor_response() + [ 'llm_instructions' => $instructions ];
	}

	private function disable_atomic_editor(): array {
		( new Opt_In() )->opt_out_v4();

		return $this->atomic_editor_response();
	}

	private function atomic_editor_response(): array {
		return [
			'success' => true,
			'atomic_editor' => Experiments_Catalog::atomic_editor_status(),
		];
	}

	private function error( string $code, string $message, int $status ): \WP_Error {
		return new \WP_Error( $code, $message, [ 'status' => $status ] );
	}
}