Create New Item
Item Type
File
Folder
Item Name
Search file in folder and subfolders...
Are you sure want to rename?
File Manager
/
wp-content
/
plugins
/
elementor
/
modules
/
mcp
/
abilities
:
agent-ready-scan-ability.php
Advanced Search
Upload
New Item
Settings
Back
Back Up
Advanced Editor
Save
<?php namespace Elementor\Modules\Mcp\Abilities; use Elementor\Modules\Agents\Module as Agents_Module; use Elementor\Modules\Mcp\Abilities\Utils\Prompt_Loader; use Elementor\Plugin; if ( ! defined( 'ABSPATH' ) ) { exit; } class Agent_Ready_Scan_Ability extends Abstract_Ability { const ACTION_READ = 'read'; const ACTION_RUN = 'run'; protected function get_ability_id(): string { return 'elementor/agent-ready-scan'; } public function is_exposed_via_proxy(): bool { return false; } protected function get_definition(): Ability_Definition { return new Ability_Definition( __( 'Agent Ready scan', 'elementor' ), Prompt_Loader::load( 'agent-ready-scan' ), 'elementor', [ 'type' => 'object', 'properties' => [ 'report' => [ 'type' => [ 'object', 'null' ], 'description' => 'Saved scan report, or null when no scan has completed yet.', ], 'retryAt' => [ 'type' => [ 'string', 'null' ], 'description' => 'ISO-8601 timestamp when another scan is allowed, if a cooldown is active.', ], ], ], [ 'annotations' => [ 'readonly' => false, 'idempotent' => false, 'destructive' => false, ], 'mutates_page' => false, ], fn() => current_user_can( 'manage_options' ), [ 'type' => 'object', 'properties' => [ 'action' => [ 'type' => 'string', 'enum' => [ self::ACTION_READ, self::ACTION_RUN ], 'default' => self::ACTION_READ, 'description' => 'read returns the saved report and cooldown. run triggers a new scan when not in cooldown.', ], ], ] ); } public function execute( $input = [] ) { if ( ! current_user_can( 'manage_options' ) ) { return $this->error( 'rest_forbidden', __( 'Sorry, you are not allowed to do that.', 'elementor' ), \WP_Http::FORBIDDEN ); } $input = is_array( $input ) ? $input : []; $action = isset( $input['action'] ) && is_string( $input['action'] ) ? $input['action'] : self::ACTION_READ; if ( ! in_array( $action, [ self::ACTION_READ, self::ACTION_RUN ], true ) ) { return $this->error( 'invalid_input', __( 'A valid action is required.', 'elementor' ), \WP_Http::BAD_REQUEST ); } $agents = $this->get_agents_module(); if ( ! $agents ) { return $this->error( 'agents_unavailable', __( 'Agent Ready is not available.', 'elementor' ), \WP_Http::SERVICE_UNAVAILABLE ); } $orchestrator = $agents->get_scanner_orchestrator(); return self::ACTION_RUN === $action ? $orchestrator->run_scan() : $orchestrator->read_saved_report(); } private function get_agents_module(): ?Agents_Module { $module = Plugin::$instance->modules_manager->get_modules( 'agents' ); return $module instanceof Agents_Module ? $module : null; } private function error( string $code, string $message, int $status ): \WP_Error { return new \WP_Error( $code, $message, [ 'status' => $status ] ); } }