AbstractApiBasedModelMetadataDirectory

21abstract class AbstractApiBasedModelMetadataDirectory implements ModelMetadataDirectoryInterface, WithHttpTransporterInterface, WithRequestAuthenticationInterface, CachesDataInterface22{23    use WithHttpTransporterTrait;24    use WithRequestAuthenticationTrait;25    use WithDataCachingTrait;26    /**27     * The cache key suffix for the models list.28     *29     * @since 0.4.030     *31     * @var string32     */33    private const MODELS_CACHE_KEY = 'models';34    /**35     * {@inheritDoc}36     *37     * @since 0.1.038     */39    final public function listModelMetadata(): array40    {41        $modelsMetadata = $this->getModelMetadataMap();42        return array_values($modelsMetadata);43    }44    /**45     * {@inheritDoc}46     *47     * @since 0.1.048     */49    final public function hasModelMetadata(string $modelId): bool50    {51        $modelsMetadata = $this->getModelMetadataMap();52        return isset($modelsMetadata[$modelId]);53    }54    /**55     * {@inheritDoc}56     *57     * @since 0.1.058     */59    final public function getModelMetadata(string $modelId): ModelMetadata60    {61        $modelsMetadata = $this->getModelMetadataMap();62        if (!isset($modelsMetadata[$modelId])) {63            throw new InvalidArgumentException(sprintf('No model with ID %s was found in the provider', $modelId));64        }65        return $modelsMetadata[$modelId];66    }67    /**68     * Returns the map of model ID to model metadata for all models from the provider.69     *70     * @since 0.1.071     *72     * @return array<string, ModelMetadata> Map of model ID to model metadata.73     */74    private function getModelMetadataMap(): array75    {76        /** @var array<string, ModelMetadata> */77        return $this->cached(self::MODELS_CACHE_KEY, fn() => $this->sendListModelsRequest(), 86400);78    }79    /**80     * {@inheritDoc}81     *82     * @since 0.4.083     */84    protected function getCachedKeys(): array85    {86        return [self::MODELS_CACHE_KEY];87    }88    /**89     * {@inheritDoc}90     *91     * @since 0.4.092     */93    protected function getBaseCacheKey(): string94    {95        return 'ai_client_' . AiClient::VERSION . '_' . md5(static::class);96    }97    /**98     * Sends the API request to list models from the provider and returns the map of model ID to model metadata.99     *100     * @since 0.1.0