Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
89.73% covered (warning)
89.73%
262 / 292
64.00% covered (warning)
64.00%
16 / 25
CRAP
0.00% covered (danger)
0.00%
0 / 1
Jetpack_AI_Page
89.86% covered (warning)
89.86%
257 / 286
64.00% covered (warning)
64.00%
16 / 25
110.43
0.00% covered (danger)
0.00%
0 / 1
 should_render_wp_build
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 is_ai_admin_request
100.00% covered (success)
100.00%
3 / 3
100.00% covered (success)
100.00%
1 / 1
3
 maybe_load_wp_build
50.00% covered (danger)
50.00%
1 / 2
0.00% covered (danger)
0.00%
0 / 1
2.50
 add_admin_shell_member
0.00% covered (danger)
0.00%
0 / 18
0.00% covered (danger)
0.00%
0 / 1
30
 load_as_admin_shell_guest
0.00% covered (danger)
0.00%
0 / 2
0.00% covered (danger)
0.00%
0 / 1
6
 add_actions
100.00% covered (success)
100.00%
12 / 12
100.00% covered (success)
100.00%
1 / 1
8
 get_page_hook
100.00% covered (success)
100.00%
12 / 12
100.00% covered (success)
100.00%
1 / 1
1
 add_page_actions
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 admin_styles
100.00% covered (success)
100.00%
4 / 4
100.00% covered (success)
100.00%
1 / 1
3
 load_agents_manager
100.00% covered (success)
100.00%
7 / 7
100.00% covered (success)
100.00%
1 / 1
2
 get_agents_manager_agent_id
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 add_scheduled_tasks_provider
100.00% covered (success)
100.00%
6 / 6
100.00% covered (success)
100.00%
1 / 1
1
 add_scheduled_tasks_data
100.00% covered (success)
100.00%
27 / 27
100.00% covered (success)
100.00%
1 / 1
1
 is_scheduled_tasks_enabled
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
1
 page_admin_scripts
100.00% covered (success)
100.00%
120 / 120
100.00% covered (success)
100.00%
1 / 1
21
 get_tracks_user_data
100.00% covered (success)
100.00%
7 / 7
100.00% covered (success)
100.00%
1 / 1
4
 is_current_user_automattician
85.71% covered (warning)
85.71%
6 / 7
0.00% covered (danger)
0.00%
0 / 1
5.07
 get_search_settings_url
100.00% covered (success)
100.00%
8 / 8
100.00% covered (success)
100.00%
1 / 1
7
 search_page_will_register
75.00% covered (warning)
75.00%
6 / 8
0.00% covered (danger)
0.00%
0 / 1
9.00
 has_my_jetpack
100.00% covered (success)
100.00%
5 / 5
100.00% covered (success)
100.00%
1 / 1
4
 get_ai_plan_info
93.75% covered (success)
93.75%
15 / 16
0.00% covered (danger)
0.00%
0 / 1
9.02
 is_jetpack_purchase
100.00% covered (success)
100.00%
1 / 1
100.00% covered (success)
100.00%
1 / 1
2
 get_wpcom_plan_purchase
87.50% covered (warning)
87.50%
7 / 8
0.00% covered (danger)
0.00%
0 / 1
5.05
 render
0.00% covered (danger)
0.00%
0 / 1
0.00% covered (danger)
0.00%
0 / 1
2
 page_render
75.00% covered (warning)
75.00%
6 / 8
0.00% covered (danger)
0.00%
0 / 1
2.06
1<?php
2/**
3 * Jetpack AI admin page.
4 *
5 * Registers the "AI" submenu item under Jetpack and mounts the React-based
6 * MCP settings interface.
7 *
8 * @package automattic/jetpack
9 */
10
11use Automattic\Jetpack\Activity_Log\Jetpack_Activity_Log;
12use Automattic\Jetpack\Activity_Log\REST_Controller as Activity_Log_REST_Controller;
13use Automattic\Jetpack\Admin_UI\Admin_Menu;
14use Automattic\Jetpack\Agents_Manager\Agents_Manager;
15use Automattic\Jetpack\Connection\Initial_State as Connection_Initial_State;
16use Automattic\Jetpack\Connection\Manager as Connection_Manager;
17use Automattic\Jetpack\Current_Plan;
18use Automattic\Jetpack\Feature_Flags\Feature_Flags;
19use Automattic\Jetpack\Modules;
20use Automattic\Jetpack\Redirect;
21use Automattic\Jetpack\Status;
22use Automattic\Jetpack\Status\Host;
23use Automattic\Jetpack\Terms_Of_Service;
24use Automattic\Jetpack\Tracking;
25
26if ( ! defined( 'ABSPATH' ) ) {
27    exit( 0 );
28}
29
30require_once dirname( __DIR__ ) . '/class-jetpack-ai-feature-flags.php';
31require_once dirname( __DIR__ ) . '/class-jetpack-ai-settings.php';
32require_once __DIR__ . '/class-jetpack-wp-build-page.php';
33
34/**
35 * Builds the Jetpack AI admin page and its sidebar menu entry.
36 */
37class Jetpack_AI_Page {
38
39    /**
40     * The wp-build route's page id, which must not be the `jetpack-ai` menu slug.
41     *
42     * @var string
43     */
44    const WP_BUILD_PAGE_ID = 'jetpack-ai-hub';
45
46    /**
47     * Activity Log actor ID that WordPress.com matches against every MCP agent event.
48     *
49     * @var string
50     */
51    const ALL_AI_AGENTS_ACTOR_ID = 'mcp:*';
52
53    /**
54     * Whether this request renders through wp-build.
55     *
56     * Checks the render function too: if the build output is missing, the request would
57     * otherwise get no bundle at all now that the legacy entry is gone.
58     *
59     * @since 16.3
60     *
61     * @return bool
62     */
63    public static function should_render_wp_build() {
64        return function_exists( 'jetpack_plugin_jetpack_ai_hub_wp_admin_render_page' );
65    }
66
67    /**
68     * Whether the current request targets the AI Hub admin page.
69     *
70     * @since 16.3
71     *
72     * @return bool
73     */
74    private static function is_ai_admin_request() {
75        if ( ! is_admin() ) {
76            return false;
77        }
78
79        // phpcs:ignore WordPress.Security.NonceVerification.Recommended -- Reading the page slug only.
80        return isset( $_GET['page'] ) && 'jetpack-ai' === sanitize_text_field( wp_unslash( $_GET['page'] ) );
81    }
82
83    /**
84     * Load wp-build for the AI Hub page.
85     *
86     * @since 16.3
87     *
88     * @return void
89     */
90    public static function maybe_load_wp_build() {
91        if ( self::is_ai_admin_request() ) {
92            Jetpack_WP_Build_Page::load( self::WP_BUILD_PAGE_ID );
93        }
94    }
95
96    /**
97     * Register Jetpack AI with the admin shell, which switches between Jetpack dashboards without a page load.
98     *
99     * @since 16.5
100     *
101     * @param array $members Shell members keyed by admin page slug.
102     * @return array
103     */
104    public function add_admin_shell_member( $members ) {
105        // Simple registers the page through mu-wpcom, and add_actions() only adds it once the site can use it.
106        if (
107            ( new Host() )->is_wpcom_simple()
108            || ! file_exists( JETPACK__PLUGIN_DIR . 'build/build.php' )
109            || ( ! Jetpack::is_connection_ready() && ! ( new Status() )->is_offline_mode() )
110        ) {
111            return $members;
112        }
113
114        $members['jetpack-ai'] = array(
115            'build_prefix' => 'jetpack_plugin',
116            'build_page'   => self::WP_BUILD_PAGE_ID,
117            'init_modules' => array( '@jetpack-plugin/init' ),
118            // "Jetpack AI" is a product name and should not be translated.
119            'title'        => 'Jetpack AI',
120            'header'       => array(
121                'title'    => 'Jetpack AI',
122                'subtitle' => __( 'Create, connect, and automate with Jetpack AI.', 'jetpack' ),
123            ),
124            'capability'   => 'manage_options',
125            'handles'      => array( 'jetpack-ai-admin', 'jetpack-script-data', 'jp-tracks-functions', 'wp-jp-i18n-loader' ),
126            'load'         => array( $this, 'load_as_admin_shell_guest' ),
127        );
128        return $members;
129    }
130
131    /**
132     * Ready the AI Hub routes and page data while another dashboard's page is open, without the screen ID alias.
133     *
134     * @since 16.5
135     *
136     * @return void
137     */
138    public function load_as_admin_shell_guest() {
139        if ( Jetpack_WP_Build_Page::load( self::WP_BUILD_PAGE_ID, false ) ) {
140            add_action( 'admin_enqueue_scripts', array( $this, 'page_admin_scripts' ) );
141        }
142    }
143
144    /**
145     * Register the page and its page-specific hooks.
146     *
147     * The AI Hub owns its full React layout, so it does not need the legacy
148     * Jetpack_Admin_Page lifecycle. Keeping this controller independent also
149     * lets WordPress.com Simple load the same page without replacing its
150     * request-wide Jetpack_Admin_Page compatibility stub.
151     */
152    public function add_actions() {
153        $is_offline_mode = ( new Status() )->is_offline_mode();
154
155        if ( ! current_user_can( 'manage_options' ) && ( $is_offline_mode || ! Jetpack::is_connection_ready() ) ) {
156            return;
157        }
158
159        if ( ! Jetpack::is_connection_ready() && ! $is_offline_mode ) {
160            return;
161        }
162
163        $hook = $this->get_page_hook();
164        if ( ! $hook ) {
165            return;
166        }
167
168        add_action( 'admin_print_scripts-' . $hook, array( $this, 'page_admin_scripts' ) );
169
170        // Preserve the standalone Jetpack page's existing base stylesheet. Simple
171        // never loaded it for the Hub because it conflicts with wpcom admin pages.
172        if ( ! ( new Host() )->is_wpcom_simple() ) {
173            add_action( 'admin_print_styles-' . $hook, array( $this, 'admin_styles' ) );
174        }
175
176        $this->add_page_actions( $hook );
177    }
178
179    /**
180     * Register the "AI" submenu under the Jetpack top-level menu.
181     *
182     * @return string|false Hook returned by Admin_Menu::add_menu().
183     */
184    public function get_page_hook() {
185        return Admin_Menu::add_menu(
186            // "Jetpack AI" is a product name and should not be translated.
187            'Jetpack AI',
188            'Jetpack AI',
189            'manage_options',
190            'jetpack-ai',
191            array( $this, 'render' ),
192            null,
193            array(
194                'product' => 'jetpack-ai',
195                'key'     => 'jetpack-ai',
196            )
197        );
198    }
199
200    /**
201     * Attach page-specific actions.
202     *
203     * @param string $hook The page hook returned by get_page_hook().
204     */
205    public function add_page_actions( $hook ) {
206        add_action( 'load-' . $hook, array( $this, 'load_agents_manager' ) );
207    }
208
209    /**
210     * Enqueue the stylesheet historically supplied by Jetpack_Admin_Page.
211     */
212    public function admin_styles() {
213        $min = ( defined( 'SCRIPT_DEBUG' ) && SCRIPT_DEBUG ) ? '' : '.min';
214
215        wp_enqueue_style( 'jetpack-admin', plugins_url( "css/jetpack-admin{$min}.css", JETPACK__PLUGIN_FILE ), array( 'genericons', 'jetpack-connection' ), JETPACK__VERSION . '-20121016' );
216        wp_style_add_data( 'jetpack-admin', 'rtl', 'replace' );
217        wp_style_add_data( 'jetpack-admin', 'suffix', $min );
218    }
219
220    /**
221     * Request the existing Agents Manager shell for this page.
222     */
223    public function load_agents_manager() {
224        if ( ! self::is_scheduled_tasks_enabled() ) {
225            return;
226        }
227
228        Agents_Manager::init();
229
230        add_filter( 'agents_manager_should_load', '__return_true' );
231        add_filter( 'agents_manager_agent_id', array( $this, 'get_agents_manager_agent_id' ) );
232        add_filter( 'agents_manager_agent_providers', array( $this, 'add_scheduled_tasks_provider' ) );
233        add_filter( 'jetpack_ai_sidebar_agents_manager_data', array( $this, 'add_scheduled_tasks_data' ) );
234    }
235
236    /**
237     * Use the generic WP Orchestrator agent in AI Hub.
238     *
239     * @return string Agent ID.
240     */
241    public function get_agents_manager_agent_id() {
242        return 'wp-orchestrator';
243    }
244
245    /**
246     * Add the AI Hub provider that supplies scheduled task starter prompts.
247     *
248     * @param array $providers Existing provider module URLs.
249     * @return array Updated provider module URLs.
250     */
251    public function add_scheduled_tasks_provider( $providers ) {
252        $providers[] = add_query_arg(
253            'ver',
254            JETPACK__VERSION,
255            plugins_url( '_inc/jetpack-ai-scheduled-tasks-provider.js', JETPACK__PLUGIN_FILE )
256        );
257
258        return $providers;
259    }
260
261    /**
262     * Customize Agents Manager's empty view for the Scheduled tasks page.
263     *
264     * @param array $data Existing Agents Manager data.
265     * @return array Updated Agents Manager data.
266     */
267    public function add_scheduled_tasks_data( $data ) {
268        $current_user = wp_get_current_user();
269
270        $data['emptyViewHeading'] = sprintf(
271            /* translators: %s: Current user's display name. */
272            __( 'Howdy %s! Let’s schedule a task.', 'jetpack' ),
273            $current_user->display_name
274        );
275        $data['emptyViewHelp']                     = __( 'Got a different request? Ask away.', 'jetpack' );
276        $data['scheduledTaskEmptyViewSuggestions'] = array(
277            array(
278                'id'         => 'create-daily-reminder',
279                'label'      => __( 'Create a daily reminder', 'jetpack' ),
280                'prompt'     => __( 'Create a daily reminder', 'jetpack' ),
281                'autoSubmit' => true,
282            ),
283            array(
284                'id'         => 'draft-weekly-post',
285                'label'      => __( 'Draft a weekly post', 'jetpack' ),
286                'prompt'     => __( 'Draft a weekly post', 'jetpack' ),
287                'autoSubmit' => true,
288            ),
289            array(
290                'id'         => 'schedule-monthly-report',
291                'label'      => __( 'Schedule a monthly report', 'jetpack' ),
292                'prompt'     => __( 'Schedule a monthly report', 'jetpack' ),
293                'autoSubmit' => true,
294            ),
295        );
296
297        return $data;
298    }
299
300    /**
301     * Whether the Scheduled tasks tab and its Agents Manager sidebar are enabled.
302     *
303     * @since 16.2
304     *
305     * @return bool
306     */
307    private static function is_scheduled_tasks_enabled() {
308        return Feature_Flags::is_enabled( Jetpack_AI_Feature_Flags::SCHEDULED_TASKS );
309    }
310
311    /**
312     * Enqueue scripts and styles for the AI admin page.
313     */
314    public function page_admin_scripts() {
315        // wp-build owns the route bundle and its dependencies; this handle only carries the
316        // inline settings below, so the plugin version is version enough to bust its cache.
317        $script_version = JETPACK__VERSION;
318
319        $blog_id     = Connection_Manager::get_site_id( true );
320        $status      = new Status();
321        $site_suffix = $status->get_site_suffix();
322        // Use the plain hostname for the Atomic activity log URL â€” get_site_suffix() can
323        // include '::' for subdirectory installs, which would break the URL. This matches
324        // the approach used by jetpack-mu-wpcom for the sidebar Activity Log link.
325        $site_host         = wp_parse_url( home_url(), PHP_URL_HOST );
326        $activity_log_site = ( is_string( $site_host ) && '' !== $site_host ) ? $site_host : $site_suffix;
327
328        // Link to the Jetpack SEO page when it registers, which takes both checks below
329        // (see the SEO package's Initializer::init()); otherwise to the Traffic card.
330        $seo_settings_url          = admin_url( 'admin.php?page=jetpack-settings#/traffic' );
331        $is_internal_test          = jetpack_is_internal_testing_environment();
332        $show_scheduled_tasks_view = self::is_scheduled_tasks_enabled();
333        if (
334            // is_available() is the newer of the two; an older SEO package loaded first can lack it.
335            method_exists( '\Automattic\Jetpack\SEO\Initializer', 'is_available' )
336            && \Automattic\Jetpack\SEO\Initializer::is_available()
337            && \Automattic\Jetpack\SEO\Initializer::is_seo_surface_visible()
338        ) {
339            $seo_settings_url = admin_url( 'admin.php?page=jetpack-seo' );
340        }
341
342        // The route bundle is registered by wp-build; this handle exists only to carry the
343        // inline settings below, which the app reads from `window.jetpackAiSettings`.
344        wp_register_script( 'jetpack-ai-admin', false, array(), $script_version, true );
345        wp_enqueue_script( 'jetpack-ai-admin' );
346
347        // The Tracks sender (w.js); without it, queued events never leave the
348        // browser. Consent-gated like the other surfaces that load it.
349        $can_send_tracks = ( new Tracking( 'jetpack', new Connection_Manager() ) )->should_enable_tracking( new Terms_Of_Service(), $status );
350        if ( $can_send_tracks ) {
351            Tracking::register_tracks_functions_scripts( true );
352        }
353
354        // Unconditional, as on the other Jetpack admin pages: the connection store
355        // reads it, and only Scheduled tasks used to need it here.
356        Connection_Initial_State::render_script( 'jetpack-ai-admin' );
357
358        $host            = new Host();
359        $has_my_jetpack  = self::has_my_jetpack();
360        $is_offline_mode = $status->is_offline_mode();
361
362        /**
363         * Filters the host-specific AI Hub configuration.
364         *
365         * @since 16.2
366         *
367         * @param array $config AI Hub host configuration.
368         */
369        $config = apply_filters(
370            'jetpack_ai_admin_config',
371            array(
372                // The Overview and Features views launch on self-hosted sites first.
373                // Keep this filterable so hosts can close them independently.
374                'showGatedViews'    => ! $host->is_wpcom_platform() || ( $host->is_woa_site() && $is_internal_test ),
375                'showA12sBadge'     => $host->is_woa_site() && $is_internal_test,
376                // The same verdicts the feature-settings endpoint reports. That call
377                // exists for the AI Features toggles; the notice must not wait on it.
378                'isUserConnected'   => Jetpack_AI_Settings::user_is_connected(),
379                'isConnected'       => Jetpack_AI_Settings::site_is_connected(),
380                'hostAllowsAi'      => Jetpack_AI_Settings::host_allows_ai(),
381                'masterEnabled'     => Jetpack_AI_Settings::is_master_enabled(),
382                // The route, not a flag: each one documents a different hook.
383                'masterForcedOff'   => Jetpack_AI_Settings::get_master_forced_off_route(),
384                'isOfflineMode'     => $is_offline_mode,
385                'canConnectSite'    => current_user_can( 'jetpack_connect' ),
386                // These three answer one question; a filter changing one alone leaves
387                // a label pointing at a page that is not there.
388                'hasMyJetpack'      => $has_my_jetpack,
389                'userConnectionUrl' => $has_my_jetpack
390                    ? 'admin.php?page=my-jetpack#/connection'
391                    : 'admin.php?page=jetpack-settings#/connect-user',
392                'manageUrl'         => $has_my_jetpack
393                    ? 'admin.php?page=my-jetpack#/features'
394                    : 'admin.php?page=jetpack_modules',
395                'mcpSettingsApi'    => array(
396                    'path'   => '/wpcom/v2/jetpack-ai/mcp-settings',
397                    'format' => 'jetpack',
398                ),
399                // Self-hosted sites get the Hub's `-self-hosted` ChatGPT and Claude connect links.
400                'isSelfHosted'      => ! $host->is_wpcom_platform(),
401            )
402        );
403
404        // WordPress.com sites use Calypso's log; self-hosted sites use the wp-admin page, which only
405        // exists while the `activity-log` module is on. An empty URL hides the row.
406        $activity_log_filtered = false;
407        if ( $host->is_wpcom_platform() ) {
408            $activity_log_url = 'https://wordpress.com/activity-log/' . $activity_log_site;
409            // Answered by the host, without a remote call.
410            $activity_log_filtered = Current_Plan::supports( 'full-activity-log' );
411        } elseif ( ( new Modules() )->is_active( 'activity-log' ) ) {
412            $activity_log_url = admin_url( 'admin.php?page=' . Jetpack_Activity_Log::PAGE_SLUG );
413            // Filters need paid access. That check can call WordPress.com, so skip it
414            // when the row can't show: offline, or without a linked user.
415            $activity_log_filtered = ! $is_offline_mode
416                && ! empty( $config['isUserConnected'] )
417                && Activity_Log_REST_Controller::has_activity_logs_access();
418        } else {
419            $activity_log_url = '';
420        }
421        if ( $activity_log_filtered ) {
422            // add_query_arg() does not encode values.
423            $activity_log_url = add_query_arg( 'actor', rawurlencode( self::ALL_AI_AGENTS_ACTOR_ID ), $activity_log_url );
424        }
425
426        $show_gated_views = ! empty( $config['showGatedViews'] );
427
428        $plan_info = $show_gated_views ? self::get_ai_plan_info() : array( 'name' => '' );
429
430        $settings = array(
431            'blogId'              => $blog_id ? (int) $blog_id : 0,
432            'activityLogUrl'      => $activity_log_url,
433            'activityLogFiltered' => $activity_log_filtered,
434            'seoSettingsUrl'      => $seo_settings_url,
435            'searchSettingsUrl'   => self::get_search_settings_url(),
436            'siteAdminUrl'        => admin_url(),
437            'userConnectionUrl'   => esc_url_raw( $config['userConnectionUrl'] ?? '' ),
438            'manageUrl'           => esc_url_raw( $config['manageUrl'] ?? '' ),
439            'hasMyJetpack'        => ! empty( $config['hasMyJetpack'] ),
440            'isConnected'         => ! empty( $config['isConnected'] ),
441            'hostAllowsAi'        => ! empty( $config['hostAllowsAi'] ),
442            'masterEnabled'       => ! empty( $config['masterEnabled'] ),
443            'masterForcedOff'     => in_array(
444                $config['masterForcedOff'] ?? '',
445                array(
446                    Jetpack_AI_Settings::FORCED_OFF_ROUTE_FILTER,
447                    Jetpack_AI_Settings::FORCED_OFF_ROUTE_FILTER_VIP,
448                    Jetpack_AI_Settings::FORCED_OFF_ROUTE_MODULES,
449                ),
450                true
451            ) ? $config['masterForcedOff'] : '',
452            'isOfflineMode'       => ! empty( $config['isOfflineMode'] ),
453            'canConnectSite'      => ! empty( $config['canConnectSite'] ),
454            'apiRoot'             => esc_url_raw( rest_url() ),
455            'apiNonce'            => wp_create_nonce( 'wp_rest' ),
456            'pluginUrl'           => plugins_url( '', JETPACK__PLUGIN_FILE ),
457            // Images ship from the plugin directory, so the plugin version is what busts their cache.
458            'assetsVersion'       => JETPACK__VERSION,
459            // The redirect entry bakes in the jetpack_ai_yearly product and
460            // a post-checkout return to this page, so both can be
461            // retargeted without shipping a code change.
462            'upgradeUrl'          => Redirect::get_url( 'jetpack-ai-hub-upgrade' ),
463            // The purchase granting AI â€” the usage card only uses it to pick
464            // the right loading-skeleton shape before the usage fetch lands.
465            // Only looked up when a gated view can render the card.
466            'planName'            => $plan_info['name'],
467            'showFeaturesView'    => $show_gated_views,
468            'showA12sBadge'       => ! empty( $config['showA12sBadge'] ),
469            // The tab and its Agents Manager sidebar ship disabled by default.
470            'featureFlags'        => array(
471                Jetpack_AI_Feature_Flags::SCHEDULED_TASKS => $show_scheduled_tasks_view,
472            ),
473            // The usage endpoint proxies as the current user, which needs
474            // their own WordPress.com account linked â€” not just the site.
475            'isUserConnected'     => ! empty( $config['isUserConnected'] ),
476            // Tracks audience properties for the jetpack_mcp_* events, per the
477            // Tracks standards for AI product events (AIINT-586). The client
478            // sends them as the strings 'true'/'false' (AIINT-576).
479            'isA11n'              => self::is_current_user_automattician(),
480            'isTest'              => $is_internal_test,
481            // Identity for Tracks; the lookup can call WordPress.com on a
482            // cache miss, so it shares the sender's guard.
483            'tracksUserData'      => $can_send_tracks ? self::get_tracks_user_data() : null,
484            'mcpSettingsApi'      => $config['mcpSettingsApi'] ?? array(),
485            'isSelfHosted'        => true === ( $config['isSelfHosted'] ?? false ),
486        );
487
488        wp_add_inline_script(
489            'jetpack-ai-admin',
490            'var jetpackAiSettings = ' . wp_json_encode(
491                $settings,
492                JSON_UNESCAPED_SLASHES | JSON_HEX_TAG | JSON_HEX_AMP
493            ) . ';',
494            'before'
495        );
496
497        /*
498         * `@automattic/jetpack-analytics` reads `window.jpTracksContext.blog_id` at
499         * event-fire time and attaches it to every Tracks event fired from this page.
500         * Without it, JS-fired events from self-hosted sites carry no blog_id â€” the
501         * Tracks pixel cannot resolve the site â€” so the events cannot be joined to
502         * plan or site data. Mirrors Connection\Initial_State::render().
503         */
504        wp_add_inline_script(
505            'jetpack-ai-admin',
506            sprintf(
507                'window.jpTracksContext = window.jpTracksContext || {}; window.jpTracksContext.blog_id = %s;',
508                absint( $blog_id )
509            ),
510            'before'
511        );
512    }
513
514    /**
515     * Connected-user identity for Tracks; null when no WordPress.com account is
516     * linked. Two keys only, so email and locale stay out of the page HTML.
517     *
518     * @return array{userid:int, username:string}|null
519     */
520    private static function get_tracks_user_data() {
521        $identity = \Jetpack_Tracks_Client::get_connected_user_tracks_identity();
522        if ( ! is_array( $identity ) || ! isset( $identity['userid'] ) || ! isset( $identity['username'] ) ) {
523            return null;
524        }
525
526        return array(
527            'userid'   => (int) $identity['userid'],
528            'username' => (string) $identity['username'],
529        );
530    }
531
532    /**
533     * Whether the current user is an Automattician.
534     *
535     * Identity check for the Tracks `is_a11n` audience property â€” it answers
536     * "who is this", not "may they use the tool", so it deliberately does not
537     * consult the MCP allowlist: allowlisted external testers are not a11ns.
538     *
539     * On wpcom Simple/Atomic the platform's is_automattician() is authoritative.
540     * Self-hosted Jetpack has no platform check; there the Tracks identity of a
541     * connected user is their WordPress.com account, so the connected account's
542     * email domain is the identity signal.
543     *
544     * @return bool
545     */
546    private static function is_current_user_automattician() {
547        if ( function_exists( 'is_automattician' ) ) {
548            return (bool) is_automattician( get_current_user_id() );
549        }
550
551        $user_data = ( new Connection_Manager() )->get_connected_user_data();
552        $email     = is_array( $user_data ) && ! empty( $user_data['email'] )
553            ? strtolower( (string) $user_data['email'] )
554            : '';
555
556        return '' !== $email && '@automattic.com' === substr( $email, -15 );
557    }
558
559    /**
560     * The Search dashboard page the AI Answers row links to, or '' once a host
561     * has removed it. Removal is remove_submenu_page() on `admin_menu`, which only
562     * unsets the registry entry â€” menu_page_url() still answers for the page and
563     * wp-admin then denies it â€” so the registry is read after that hook has run.
564     *
565     * @return string
566     */
567    private static function get_search_settings_url() {
568        global $submenu;
569
570        $url = admin_url( 'admin.php?page=jetpack-search#/ai-answers' );
571
572        // The admin shell's guest endpoint runs on admin-ajax, which never builds the menu.
573        if ( wp_doing_ajax() ) {
574            return self::search_page_will_register() ? $url : '';
575        }
576
577        // Search registers under the Jetpack menu, or menu-less (parent '') when
578        // `jetpack_search_should_add_search_submenu` says no; both are reachable.
579        foreach ( array( 'jetpack', '' ) as $parent ) {
580            foreach ( (array) ( $submenu[ $parent ] ?? array() ) as $item ) {
581                if ( isset( $item[2] ) && 'jetpack-search' === $item[2] ) {
582                    return $url;
583                }
584            }
585        }
586
587        return '';
588    }
589
590    /**
591     * Whether the Search dashboard has hooked its page registration, for requests that never build the menu.
592     *
593     * A host that removes the page on `admin_menu` isn't seen here.
594     *
595     * @since 16.5
596     *
597     * @return bool
598     */
599    private static function search_page_will_register() {
600        global $wp_filter;
601        if ( ! class_exists( '\Automattic\Jetpack\Search\Dashboard' ) || ! isset( $wp_filter['admin_menu'] ) ) {
602            return false;
603        }
604        foreach ( $wp_filter['admin_menu']->callbacks as $callbacks ) {
605            foreach ( $callbacks as $callback ) {
606                $function = $callback['function'];
607                if ( is_array( $function ) && $function[0] instanceof \Automattic\Jetpack\Search\Dashboard && 'add_wp_admin_submenu' === $function[1] ) {
608                    return true;
609                }
610            }
611        }
612        return false;
613    }
614
615    /**
616     * Whether My Jetpack is loaded on this host.
617     *
618     * Hosts drop it with the `jetpack_my_jetpack_should_initialize` filter, and
619     * VIP removes it from outside this codebase, where that filter cannot answer.
620     *
621     * @return bool
622     */
623    private static function has_my_jetpack() {
624        if ( ( new Host() )->is_vip_site() ) {
625            return false;
626        }
627
628        return class_exists( 'Automattic\\Jetpack\\My_Jetpack\\Initializer' )
629            && method_exists( 'Automattic\\Jetpack\\My_Jetpack\\Initializer', 'should_initialize' )
630            && \Automattic\Jetpack\My_Jetpack\Initializer::should_initialize();
631    }
632
633    /**
634     * Name of the purchase granting this site AI ("Jetpack Complete"), from
635     * My Jetpack's purchase data â€” its Plans section's source.
636     *
637     * @return array{name: string} An empty string when nothing paid grants AI
638     *                             or the data is unavailable.
639     */
640    private static function get_ai_plan_info() {
641        $empty = array( 'name' => '' );
642
643        if ( ! class_exists( '\Automattic\Jetpack\My_Jetpack\Products\Jetpack_Ai' ) ) {
644            return $empty;
645        }
646
647        // The purchase lookup can make remote requests; cache the outcome
648        // (empty included) so the admin page pays that cost at most hourly.
649        $cached = get_transient( 'jetpack_ai_overview_plan_info' );
650        if ( is_array( $cached ) ) {
651            return array_merge( $empty, $cached );
652        }
653
654        // A failed lookup is not "no purchase": skip the hour-long cache so the
655        // next page load can try again instead of pinning a blank name.
656        if ( is_wp_error( \Automattic\Jetpack\My_Jetpack\Wpcom_Products::get_site_current_purchases() ) ) {
657            return $empty;
658        }
659
660        $purchase = \Automattic\Jetpack\My_Jetpack\Products\Jetpack_Ai::get_paid_plan_purchase_for_product();
661
662        // A WordPress.com site names its own plan, never a Jetpack one.
663        if ( self::is_jetpack_purchase( $purchase ) && ( new Host() )->is_woa_site() ) {
664            $purchase = self::get_wpcom_plan_purchase();
665        }
666
667        $info = $empty;
668        if ( $purchase && ! empty( $purchase->product_name ) && 'expired' !== ( $purchase->expiry_status ?? '' ) ) {
669            // The design shows the bare plan name ("Complete", "Business"), so
670            // trim the store names' brand prefixes; they are untranslated.
671            $info['name'] = (string) preg_replace( '/^(Jetpack|WordPress\.com) /', '', (string) $purchase->product_name );
672        }
673
674        set_transient( 'jetpack_ai_overview_plan_info', $info, HOUR_IN_SECONDS );
675
676        return $info;
677    }
678
679    /**
680     * Whether a purchase was bought from the Jetpack store.
681     *
682     * @param object|null $purchase Purchase from My Jetpack.
683     * @return bool
684     */
685    private static function is_jetpack_purchase( $purchase ) {
686        return (bool) $purchase && 0 === strpos( (string) ( $purchase->product_slug ?? '' ), 'jetpack_' );
687    }
688
689    /**
690     * The purchase behind the site's current WordPress.com plan.
691     *
692     * The plan record carries only a slug and a display name lives on purchases,
693     * so the slug is matched back to the purchase that created it.
694     *
695     * @return object|null Null when the plan or its purchase cannot be found.
696     */
697    private static function get_wpcom_plan_purchase() {
698        $current_plan = \Automattic\Jetpack\My_Jetpack\Wpcom_Products::get_site_current_plan();
699        $plan_slug    = is_array( $current_plan ) && ! empty( $current_plan['product_slug'] )
700            ? (string) $current_plan['product_slug']
701            : '';
702
703        // An empty slug simply matches nothing below, so it needs no guard.
704        foreach ( (array) \Automattic\Jetpack\My_Jetpack\Wpcom_Products::get_site_current_purchases() as $purchase ) {
705            if ( $plan_slug === ( $purchase->product_slug ?? '' ) ) {
706                return $purchase;
707            }
708        }
709
710        return null;
711    }
712
713    /**
714     * Override the base render() to skip wrap_ui entirely.
715     *
716     * Wrap_ui renders the Jetpack masthead header and static footer, which
717     * duplicate the header/footer that AdminPage (React) already provides.
718     * Calling page_render() directly lets AdminPage own the full layout.
719     */
720    public function render() {
721        $this->page_render();
722    }
723
724    /**
725     * Render the page, or say why it could not be rendered.
726     *
727     * The generated wp-build page owns the markup the app mounts into.
728     */
729    public function page_render() {
730        if ( self::should_render_wp_build() ) {
731            jetpack_plugin_jetpack_ai_hub_wp_admin_render_page(); // @phan-suppress-current-line PhanUndeclaredFunction -- should_render_wp_build() checks function_exists(); defined in the generated build/pages/, which Phan excludes.
732            return;
733        }
734
735        // The build output is missing; say so rather than leaving a silent blank page.
736        printf(
737            '<div class="wrap"><h1>%s</h1><div class="notice notice-error"><p>%s</p></div></div>',
738            esc_html__( 'Jetpack AI', 'jetpack' ),
739            esc_html__( 'Jetpack AI could not be loaded because its assets are missing. Reinstalling or updating the plugin usually fixes this. If it keeps happening, contact your site administrator or host.', 'jetpack' )
740        );
741    }
742}
743
744/*
745 * wp-build must load before add_actions() runs on any host, so hook it here: Jetpack_Admin and
746 * mu-wpcom's WordPress.com Simple integration both require this file before `admin_menu`, and
747 * add_action() dedupes.
748 */
749add_action( 'admin_menu', array( 'Jetpack_AI_Page', 'maybe_load_wp_build' ), 1 );