refactor: namespaces PSR classes and corrects versions

Author: JasonTheAdams

src/wp-includes/ai-client-utils/class-wp-ai-client-ability-function-resolver.php

@@ -4,7 +4,7 @@
  *
  * @package WordPress
  * @subpackage AI
- * @since 6.8.0
+ * @since 7.0.0
  */
 
 use WordPress\AiClient\Messages\DTO\Message;
@@ -16,22 +16,22 @@
 /**
  * Resolves and executes WordPress Abilities API function calls from AI models.
  *
- * @since 6.8.0
+ * @since 7.0.0
  */
 class WP_AI_Client_Ability_Function_Resolver {
 
 	/**
 	 * Prefix used to identify ability function calls.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 * @var string
 	 */
 	private const ABILITY_PREFIX = 'wpab__';
 
 	/**
 	 * Checks if a function call is an ability call.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param FunctionCall $call The function call to check.
 	 * @return bool True if the function call is an ability call, false otherwise.
@@ -48,7 +48,7 @@ public static function is_ability_call( FunctionCall $call ): bool {
 	/**
 	 * Executes a WordPress ability from a function call.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param FunctionCall $call The function call to execute.
 	 * @return FunctionResponse The response from executing the ability.
@@ -107,7 +107,7 @@ public static function execute_ability( FunctionCall $call ): FunctionResponse {
 	/**
 	 * Checks if a message contains any ability function calls.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param Message $message The message to check.
 	 * @return bool True if the message contains ability calls, false otherwise.
@@ -128,7 +128,7 @@ public static function has_ability_calls( Message $message ): bool {
 	/**
 	 * Executes all ability function calls in a message.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param Message $message The message containing function calls.
 	 * @return Message A new message with function responses.
@@ -154,7 +154,7 @@ public static function execute_abilities( Message $message ): Message {
 	 *
 	 * Transforms "tec/create_event" to "wpab__tec__create_event".
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string $ability_name The ability name to convert.
 	 * @return string The function name.
@@ -168,7 +168,7 @@ public static function ability_name_to_function_name( string $ability_name ): st
 	 *
 	 * Transforms "wpab__tec__create_event" to "tec/create_event".
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string $function_name The function name to convert.
 	 * @return string The ability name.

src/wp-includes/ai-client-utils/class-wp-ai-client-discovery-strategy.php

@@ -4,27 +4,27 @@
  *
  * @package WordPress
  * @subpackage AI
- * @since 6.8.0
+ * @since 7.0.0
  */
 
 use WordPress\AiClientDependencies\Http\Discovery\Psr18ClientDiscovery;
 use WordPress\AiClientDependencies\Http\Discovery\Strategy\DiscoveryStrategy;
-use Psr\Http\Client\ClientInterface;
+use WordPress\AiClientDependencies\Psr\Http\Client\ClientInterface;
 
 /**
  * Discovery strategy for WordPress HTTP client.
  *
  * Registers the WordPress HTTP client adapter with the HTTPlug discovery system
  * so the AI Client SDK can find and use it automatically.
  *
- * @since 6.8.0
+ * @since 7.0.0
  */
 class WP_AI_Client_Discovery_Strategy implements DiscoveryStrategy {
 
 	/**
 	 * Initializes and registers the discovery strategy.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 */
 	public static function init() {
 		if ( ! class_exists( '\WordPress\AiClientDependencies\Http\Discovery\Psr18ClientDiscovery' ) ) {
@@ -37,7 +37,7 @@ public static function init() {
 	/**
 	 * Gets candidates for discovery.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string $type The type of discovery.
 	 * @return array<array<string, mixed>> List of candidates.
@@ -54,12 +54,12 @@ public static function getCandidates( $type ) {
 		}
 
 		$psr17_factories = array(
-			'Psr\Http\Message\RequestFactoryInterface',
-			'Psr\Http\Message\ResponseFactoryInterface',
-			'Psr\Http\Message\ServerRequestFactoryInterface',
-			'Psr\Http\Message\StreamFactoryInterface',
-			'Psr\Http\Message\UploadedFileFactoryInterface',
-			'Psr\Http\Message\UriFactoryInterface',
+			'WordPress\AiClientDependencies\Psr\Http\Message\RequestFactoryInterface',
+			'WordPress\AiClientDependencies\Psr\Http\Message\ResponseFactoryInterface',
+			'WordPress\AiClientDependencies\Psr\Http\Message\ServerRequestFactoryInterface',
+			'WordPress\AiClientDependencies\Psr\Http\Message\StreamFactoryInterface',
+			'WordPress\AiClientDependencies\Psr\Http\Message\UploadedFileFactoryInterface',
+			'WordPress\AiClientDependencies\Psr\Http\Message\UriFactoryInterface',
 		);
 
 		if ( in_array( $type, $psr17_factories, true ) ) {
@@ -76,7 +76,7 @@ public static function getCandidates( $type ) {
 	/**
 	 * Creates an instance of the WordPress HTTP client.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @return WP_AI_Client_HTTP_Client
 	 */

src/wp-includes/ai-client-utils/class-wp-ai-client-event-dispatcher.php

@@ -4,18 +4,18 @@
  *
  * @package WordPress
  * @subpackage AI
- * @since 6.8.0
+ * @since 7.0.0
  */
 
-use Psr\EventDispatcher\EventDispatcherInterface;
+use WordPress\AiClientDependencies\Psr\EventDispatcher\EventDispatcherInterface;
 
 /**
  * WordPress-specific PSR-14 event dispatcher for the AI Client.
  *
  * Bridges PSR-14 events to WordPress action hooks, enabling plugins to hook
  * into AI client lifecycle events.
  *
- * @since 6.8.0
+ * @since 7.0.0
  */
 class WP_AI_Client_Event_Dispatcher implements EventDispatcherInterface {
 
@@ -25,7 +25,7 @@ class WP_AI_Client_Event_Dispatcher implements EventDispatcherInterface {
 	 * Converts the event class name to a WordPress action hook name and fires it.
 	 * For example, BeforeGenerateResultEvent becomes wp_ai_client_before_generate_result.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param object $event The event object to dispatch.
 	 * @return object The same event object, potentially modified by listeners.
@@ -47,7 +47,7 @@ public function dispatch( object $event ): object {
 		 * - wp_ai_client_before_generate_result
 		 * - wp_ai_client_after_generate_result
 		 *
-		 * @since 6.8.0
+		 * @since 7.0.0
 		 *
 		 * @param object $event The event object.
 		 */
@@ -59,7 +59,7 @@ public function dispatch( object $event ): object {
 	/**
 	 * Converts an event object class name to a WordPress action hook name portion.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param object $event The event object.
 	 * @return string The hook name portion derived from the event class name.

src/wp-includes/ai-client-utils/class-wp-ai-client-http-client.php

@@ -4,14 +4,14 @@
  *
  * @package WordPress
  * @subpackage AI
- * @since 6.8.0
+ * @since 7.0.0
  */
 
-use Psr\Http\Client\ClientInterface;
-use Psr\Http\Message\RequestInterface;
-use Psr\Http\Message\ResponseInterface;
-use Psr\Http\Message\ResponseFactoryInterface;
-use Psr\Http\Message\StreamFactoryInterface;
+use WordPress\AiClientDependencies\Psr\Http\Client\ClientInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\RequestInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\ResponseInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\ResponseFactoryInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\StreamFactoryInterface;
 use WordPress\AiClient\Providers\Http\Contracts\ClientWithOptionsInterface;
 use WordPress\AiClient\Providers\Http\DTO\RequestOptions;
 use WordPress\AiClient\Providers\Http\Exception\NetworkException;
@@ -22,30 +22,30 @@
  * Allows WordPress HTTP functions to be used as a PSR-18 compliant HTTP client
  * for the AI Client SDK.
  *
- * @since 6.8.0
+ * @since 7.0.0
  */
 class WP_AI_Client_HTTP_Client implements ClientInterface, ClientWithOptionsInterface {
 
 	/**
 	 * Response factory instance.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 * @var ResponseFactoryInterface
 	 */
 	private $response_factory;
 
 	/**
 	 * Stream factory instance.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 * @var StreamFactoryInterface
 	 */
 	private $stream_factory;
 
 	/**
 	 * Constructor.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param ResponseFactoryInterface $response_factory PSR-17 Response factory.
 	 * @param StreamFactoryInterface   $stream_factory   PSR-17 Stream factory.
@@ -58,7 +58,7 @@ public function __construct( ResponseFactoryInterface $response_factory, StreamF
 	/**
 	 * Sends a PSR-7 request and returns a PSR-7 response.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param RequestInterface $request The PSR-7 request.
 	 * @return ResponseInterface The PSR-7 response.
@@ -88,7 +88,7 @@ public function sendRequest( RequestInterface $request ): ResponseInterface {
 	/**
 	 * Sends a PSR-7 request with transport options and returns a PSR-7 response.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param RequestInterface $request The PSR-7 request.
 	 * @param RequestOptions   $options Transport options for the request.
@@ -121,7 +121,7 @@ public function sendRequestWithOptions( RequestInterface $request, RequestOption
 	/**
 	 * Prepares WordPress HTTP API arguments from a PSR-7 request.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param RequestInterface    $request The PSR-7 request.
 	 * @param RequestOptions|null $options Optional transport options for the request.
@@ -152,7 +152,7 @@ private function prepare_wp_args( RequestInterface $request, ?RequestOptions $op
 	/**
 	 * Prepares headers for WordPress HTTP API.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param RequestInterface $request The PSR-7 request.
 	 * @return array<string, string> Headers array for WordPress HTTP API.
@@ -174,7 +174,7 @@ private function prepare_headers( RequestInterface $request ): array {
 	/**
 	 * Prepares request body for WordPress HTTP API.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param RequestInterface $request The PSR-7 request.
 	 * @return string|null The request body.
@@ -196,7 +196,7 @@ private function prepare_body( RequestInterface $request ): ?string {
 	/**
 	 * Creates a PSR-7 response from a WordPress HTTP response.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param array<string, mixed> $wp_response WordPress HTTP API response array.
 	 * @return ResponseInterface PSR-7 response.

src/wp-includes/ai-client-utils/class-wp-ai-client-psr17-factory.php

@@ -4,32 +4,32 @@
  *
  * @package WordPress
  * @subpackage AI
- * @since 6.8.0
+ * @since 7.0.0
  */
 
-use Psr\Http\Message\RequestFactoryInterface;
-use Psr\Http\Message\RequestInterface;
-use Psr\Http\Message\ResponseFactoryInterface;
-use Psr\Http\Message\ResponseInterface;
-use Psr\Http\Message\StreamFactoryInterface;
-use Psr\Http\Message\StreamInterface;
-use Psr\Http\Message\UriFactoryInterface;
-use Psr\Http\Message\UriInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\RequestFactoryInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\RequestInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\ResponseFactoryInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\ResponseInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\StreamFactoryInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\StreamInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\UriFactoryInterface;
+use WordPress\AiClientDependencies\Psr\Http\Message\UriInterface;
 
 /**
  * Combined PSR-17 factory for creating PSR-7 HTTP message objects.
  *
  * Implements all four PSR-17 factory interfaces, delegating to the minimal
  * WP AI Client PSR-7 implementations.
  *
- * @since 6.8.0
+ * @since 7.0.0
  */
 class WP_AI_Client_PSR17_Factory implements RequestFactoryInterface, ResponseFactoryInterface, StreamFactoryInterface, UriFactoryInterface {
 
 	/**
 	 * Creates a new request.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string              $method The HTTP method associated with the request.
 	 * @param UriInterface|string $uri    The URI associated with the request.
@@ -42,7 +42,7 @@ public function createRequest( string $method, $uri ): RequestInterface {
 	/**
 	 * Creates a new response.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param int    $code         HTTP status code. Defaults to 200.
 	 * @param string $reasonPhrase Reason phrase to associate with status code.
@@ -55,7 +55,7 @@ public function createResponse( int $code = 200, string $reasonPhrase = '' ): Re
 	/**
 	 * Creates a new stream from a string.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string $content String content with which to populate the stream.
 	 * @return StreamInterface
@@ -67,7 +67,7 @@ public function createStream( string $content = '' ): StreamInterface {
 	/**
 	 * Creates a stream from an existing file.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string $filename Filename or stream URI to use as basis of stream.
 	 * @param string $mode     Mode with which to open the underlying filename/stream.
@@ -86,7 +86,7 @@ public function createStreamFromFile( string $filename, string $mode = 'r' ): St
 	/**
 	 * Creates a new stream from an existing resource.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param resource $resource PHP resource to use as basis of stream.
 	 * @return StreamInterface
@@ -104,7 +104,7 @@ public function createStreamFromResource( $resource ): StreamInterface {
 	/**
 	 * Creates a new URI.
 	 *
-	 * @since 6.8.0
+	 * @since 7.0.0
 	 *
 	 * @param string $uri The URI string.
 	 * @return UriInterface