ProviderRegistry::registerProvider( WordPress\AiClient\Providers\class-string<ProviderInterface> $className )

58    public function registerProvider(string $className): void59    {60        if (!class_exists($className)) {61            throw new InvalidArgumentException(sprintf('Provider class does not exist: %s', $className));62        }63        // Validate that class implements ProviderInterface64        if (!is_subclass_of($className, ProviderInterface::class)) {65            throw new InvalidArgumentException(sprintf('Provider class must implement %s: %s', ProviderInterface::class, $className));66        }67        $metadata = $className::metadata();68        if (!$metadata instanceof ProviderMetadata) {69            throw new InvalidArgumentException(sprintf('Provider must return ProviderMetadata from metadata() method: %s', $className));70        }71        // If there is already a HTTP transporter instance set, hook it up to the provider as needed.72        try {73            $httpTransporter = $this->getHttpTransporter();74        } catch (RuntimeException $e) {75            /*76             * If this fails, it's okay. There is no defined sequence between setting the HTTP transporter in the77             * registry and registering providers in it, so it might be that the transporter is set later. It will be78             * hooked up then.79             * But for now we can ignore this exception and attempt to set the default HTTP transporter, if possible.80             */81            try {82                $this->setHttpTransporter(HttpTransporterFactory::createTransporter());83                $httpTransporter = $this->getHttpTransporter();84            } catch (DiscoveryNotFoundException $e) {85                /*86                 * If no HTTP client implementation can be discovered yet, we can ignore this for now.87                 * It might be set later, so it's not a hard error at this point.88                 * We'll try again the next time a provider is registered, or maybe by that time an explicit89                 * HTTP transporter will have been set.90                 */91            }92        }93        if (isset($httpTransporter)) {94            $this->setHttpTransporterForProvider($className, $httpTransporter);95        }96        // Hook up the request authentication instance, using a default if not set.97        if (!isset($this->providerAuthenticationInstances[$className])) {98            $defaultProviderAuthentication = $this->createDefaultProviderRequestAuthentication($className);99            if ($defaultProviderAuthentication !== null) {100                $this->providerAuthenticationInstances[$className] = $defaultProviderAuthentication;101            }102        }103        if (isset($this->providerAuthenticationInstances[$className])) {104            $this->setRequestAuthenticationForProvider($className, $this->providerAuthenticationInstances[$className]);105        }106        $this->registeredIdsToClassNames[$metadata->getId()] = $className;107        $this->registeredClassNamesToIds[$className] = $metadata->getId();108    }