ModelRequirements

29class ModelRequirements extends AbstractDataTransferObject30{31    public const KEY_REQUIRED_CAPABILITIES = 'requiredCapabilities';32    public const KEY_REQUIRED_OPTIONS = 'requiredOptions';33    /**34     * @var list<CapabilityEnum> The capabilities that the model must support.35     */36    protected array $requiredCapabilities;37    /**38     * @var list<RequiredOption> The options that the model must support with specific values.39     */40    protected array $requiredOptions;41    /**42     * Constructor.43     *44     * @since 0.1.045     *46     * @param list<CapabilityEnum> $requiredCapabilities The capabilities that the model must support.47     * @param list<RequiredOption> $requiredOptions The options that the model must support with specific values.48     *49     * @throws InvalidArgumentException If arrays are not lists.50     */51    public function __construct(array $requiredCapabilities, array $requiredOptions)52    {53        if (!array_is_list($requiredCapabilities)) {54            throw new InvalidArgumentException('Required capabilities must be a list array.');55        }56        if (!array_is_list($requiredOptions)) {57            throw new InvalidArgumentException('Required options must be a list array.');58        }59        $this->requiredCapabilities = $requiredCapabilities;60        $this->requiredOptions = $requiredOptions;61    }62    /**63     * Gets the capabilities that the model must support.64     *65     * @since 0.1.066     *67     * @return list<CapabilityEnum> The required capabilities.68     */69    public function getRequiredCapabilities(): array70    {71        return $this->requiredCapabilities;72    }73    /**74     * Gets the options that the model must support with specific values.75     *76     * @since 0.1.077     *78     * @return list<RequiredOption> The required options.79     */80    public function getRequiredOptions(): array81    {82        return $this->requiredOptions;83    }84    /**85     * Checks whether the given model metadata meets these requirements.86     *87     * @since 0.2.088     *89     * @param ModelMetadata $metadata The model metadata to check against.90     * @return bool True if the model meets all requirements, false otherwise.91     */92    public function areMetBy(\WordPress\AiClient\Providers\Models\DTO\ModelMetadata $metadata): bool93    {94        // Create lookup maps for better performance (instead of nested foreach loops)95        $capabilitiesMap = [];96        foreach ($metadata->getSupportedCapabilities() as $capability) {97            $capabilitiesMap[$capability->value] = $capability;98        }99        $optionsMap = [];100        foreach ($metadata->getSupportedOptions() as $option) {101            $optionsMap[$option->getName()->value] = $option;102        }103        // Check if all required capabilities are supported using map lookup104        foreach ($this->requiredCapabilities as $requiredCapability) {105            if (!isset($capabilitiesMap[$requiredCapability->value])) {106                return \false;107            }108        }