# elementor/4.3.0-beta2/modules/agents/module.php

Elementor Website Builder – more than just a page builder, version 4.3.0-beta2. 223 lines.

- Page: https://pluginprobe.com/plugins/elementor/4.3.0-beta2/code/modules/agents/module.php
- Raw: https://pluginprobe.com/plugins/elementor/4.3.0-beta2/raw/modules/agents/module.php
- Modified: 2026-09-01T11:47:36+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/elementor/4.3.0-beta2/code/modules/agents/module.php#L10-L20`.

```php
<?php

namespace Elementor\Modules\Agents;

use Elementor\Core\Base\Module as BaseModule;
use Elementor\Core\Experiments\Manager as Experiments_Manager;
use Elementor\Core\Kits\Documents\Kit;
use Elementor\Core\Kits\Documents\Tabs\Settings_Agents;
use Elementor\Plugin;
use Elementor\Utils;

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

class Module extends BaseModule {

	const EXPERIMENT_NAME = 'agents_llms_txt';

	const PACKAGES = [
		'editor-agents',
	];

	const DEFAULT_CACHE_MAX_AGE = 300;

	public function get_name() {
		return 'agents';
	}

	public static function get_experimental_data() {
		return [
			'name' => self::EXPERIMENT_NAME,
			'title' => esc_html__( 'Agents llms.txt', 'elementor' ),
			'description' => esc_html__( 'Expose llms.txt from site settings at the site root for AI agents.', 'elementor' ),
			'hidden' => true,
			'default' => Experiments_Manager::STATE_INACTIVE,
			'release_status' => Experiments_Manager::RELEASE_STATUS_DEV,
		];
	}

	public function __construct() {
		parent::__construct();

		add_action( 'template_redirect', [ $this, 'maybe_serve_llms_txt' ], 1 );
		add_action( 'elementor/kit/register_tabs', [ $this, 'register_kit_tabs' ] );
		add_action( 'elementor/document/after_save', [ $this, 'maybe_invalidate_llms_txt_cache' ] );

		if ( Plugin::$instance->experiments->is_feature_active( self::EXPERIMENT_NAME ) ) {
			add_filter( 'elementor/editor/v2/packages', fn ( $packages ) => $this->add_packages( $packages ) );
		}
	}

	/**
	 * @param \Elementor\Core\Kits\Documents\Kit $kit
	 */
	public function register_kit_tabs( $kit ) {
		if ( ! Plugin::$instance->experiments->is_feature_active( self::EXPERIMENT_NAME ) ) {
			return;
		}

		$kit->register_tab( 'settings-agents', Settings_Agents::class );
	}

	public function maybe_serve_llms_txt() {
		if ( ! $this->is_llms_txt_request() ) {
			return;
		}

		$llms = $this->get_llms_txt_content();

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

		$etag = $this->get_etag( $llms );
		$last_modified = $this->get_last_modified();

		header( 'X-Content-Type-Options: nosniff' );
		header( 'Cache-Control: public, max-age=' . $this->get_cache_max_age() );
		header( 'ETag: ' . $etag );

		if ( $last_modified ) {
			header( 'Last-Modified: ' . gmdate( 'D, d M Y H:i:s', $last_modified ) . ' GMT' );
		}

		if ( $this->is_client_cache_fresh( $etag, $last_modified ) ) {
			status_header( 304 );
			exit;
		}

		status_header( 200 );
		header( 'Content-Type: text/plain; charset=utf-8' );
		Utils::print_unescaped_internal_string( $llms );
		exit;
	}

	/**
	 * The served content is derived from kit settings, so a kit save is the only way it can change.
	 *
	 * @param mixed $document
	 */
	public function maybe_invalidate_llms_txt_cache( $document ) {
		if ( ! $document instanceof Kit ) {
			return;
		}

		/**
		 * Fires when the /llms.txt response may have changed, so external page caches and CDNs
		 * can purge their copy instead of serving it until `max-age` expires.
		 *
		 * @param int $kit_id The saved kit ID.
		 */
		do_action( 'elementor/agents/llms_txt/cache_invalidated', $document->get_main_id() );
	}

	public function get_llms_txt_content(): string {
		$kit = Plugin::$instance->kits_manager->get_active_kit();
		$agents = $kit->get_settings( 'agents' );

		if ( ! is_array( $agents ) || ! isset( $agents['llms'] ) ) {
			return '';
		}

		$llms = $agents['llms'];

		return is_string( $llms ) ? $llms : '';
	}

	private function add_packages( $packages ) {
		return array_merge( $packages, self::PACKAGES );
	}

	private function get_cache_max_age(): int {
		/**
		 * Filters how long (in seconds) clients and shared caches may reuse /llms.txt without revalidating.
		 *
		 * @param int $max_age Cache lifetime in seconds.
		 */
		$max_age = (int) apply_filters( 'elementor/agents/llms_txt/cache_max_age', self::DEFAULT_CACHE_MAX_AGE );

		return max( 0, $max_age );
	}

	private function get_etag( string $content ): string {
		return '"' . md5( $content ) . '"';
	}

	private function get_last_modified(): int {
		$modified = get_post_modified_time( 'U', true, Plugin::$instance->kits_manager->get_active_id() );

		return is_numeric( $modified ) ? (int) $modified : 0;
	}

	private function is_client_cache_fresh( string $etag, int $last_modified ): bool {
		$if_none_match = isset( $_SERVER['HTTP_IF_NONE_MATCH'] )
			? trim( sanitize_text_field( wp_unslash( $_SERVER['HTTP_IF_NONE_MATCH'] ) ) )
			: '';

		// An ETag mismatch must win over If-Modified-Since, which only has one-second resolution.
		if ( '' !== $if_none_match ) {
			return $this->etag_matches( $if_none_match, $etag );
		}

		$if_modified_since = isset( $_SERVER['HTTP_IF_MODIFIED_SINCE'] )
			? trim( sanitize_text_field( wp_unslash( $_SERVER['HTTP_IF_MODIFIED_SINCE'] ) ) )
			: '';

		if ( ! $last_modified || '' === $if_modified_since ) {
			return false;
		}

		$since = strtotime( $if_modified_since );

		return false !== $since && $since >= $last_modified;
	}

	private function etag_matches( string $header, string $etag ): bool {
		foreach ( explode( ',', $header ) as $candidate ) {
			$candidate = trim( $candidate );

			if ( '*' === $candidate ) {
				return true;
			}

			if ( 0 === strpos( $candidate, 'W/' ) ) {
				$candidate = substr( $candidate, 2 );
			}

			if ( $candidate === $etag ) {
				return true;
			}
		}

		return false;
	}

	private function is_llms_txt_request(): bool {
		$request_uri = isset( $_SERVER['REQUEST_URI'] )
			? sanitize_text_field( wp_unslash( $_SERVER['REQUEST_URI'] ) )
			: '';

		$path = wp_parse_url( $request_uri, PHP_URL_PATH );

		if ( ! is_string( $path ) ) {
			return false;
		}

		$home_path = wp_parse_url( home_url(), PHP_URL_PATH );

		if ( is_string( $home_path ) && '' !== $home_path && '/' !== $home_path ) {
			$home_path = untrailingslashit( $home_path );

			if ( 0 === strpos( $path, $home_path ) ) {
				$path = substr( $path, strlen( $home_path ) );
			}
		}

		$path = untrailingslashit( $path );

		return '/llms.txt' === $path || 'llms.txt' === ltrim( $path, '/' );
	}
}

```