PromptBuilder::getConfiguredModel( WordPress\AiClient\Providers\Models\Enums\CapabilityEnum $capability ): WordPress\AiClient\Providers\Models\Contracts\ModelInterface

1148    private function getConfiguredModel(CapabilityEnum $capability): ModelInterface1149    {1150        $requirements = ModelRequirements::fromPromptData($capability, $this->messages, $this->modelConfig);1151        if ($this->model !== null) {1152            // Explicit model was provided via usingModel(); just update config and bind dependencies.1153            $model = $this->model;1154            $model->setConfig($this->modelConfig);1155            $this->registry->bindModelDependencies($model);1156            $this->bindModelRequestOptions($model);1157            return $model;1158        }1159        // Retrieve the candidate models map which satisfies the requirements.1160        $candidateMap = $this->getCandidateModelsMap($requirements);1161        if (empty($candidateMap)) {1162            $message = sprintf('No models found that support %s for this prompt.', $capability->value);1163            if ($this->providerIdOrClassName !== null) {1164                $message = sprintf('No models found for provider "%s" that support %s for this prompt.', $this->providerIdOrClassName, $capability->value);1165            }1166            throw new InvalidArgumentException($message);1167        }1168        // Check if any preferred models match the candidates, in priority order.1169        if (!empty($this->modelPreferenceKeys)) {1170            // Find preferences that match available candidates, preserving preference order.1171            $matchingPreferences = array_intersect_key(array_flip($this->modelPreferenceKeys), $candidateMap);1172            if (!empty($matchingPreferences)) {1173                // Get the first matching preference key1174                $firstMatchKey = key($matchingPreferences);1175                [$providerId, $modelId] = $candidateMap[$firstMatchKey];1176                $model = $this->registry->getProviderModel($providerId, $modelId, $this->modelConfig);1177                $this->bindModelRequestOptions($model);1178                return $model;1179            }1180        }1181        // No preference matched; fall back to the first candidate discovered.1182        [$providerId, $modelId] = reset($candidateMap);1183        $model = $this->registry->getProviderModel($providerId, $modelId, $this->modelConfig);1184        $this->bindModelRequestOptions($model);1185        return $model;1186    }