<h2>File Contents: /home/planet5/www/wp-includes/php-ai-client/src/Providers/Models/DTO/copy_of_ModelConfig.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-includes/php-ai-client/src/Providers/Models/DTO/copy_of_ModelConfig.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

declare (strict_types=1);
namespace WordPress\AiClient\Providers\Models\DTO;

use WordPress\AiClient\Common\AbstractDataTransferObject;
use WordPress\AiClient\Common\Exception\InvalidArgumentException;
use WordPress\AiClient\Files\Enums\FileTypeEnum;
use WordPress\AiClient\Files\Enums\MediaOrientationEnum;
use WordPress\AiClient\Messages\Enums\ModalityEnum;
use WordPress\AiClient\Tools\DTO\FunctionDeclaration;
use WordPress\AiClient\Tools\DTO\WebSearch;
/**
 * Represents configuration for an AI model.
 *
 * This class allows configuring various parameters for model behavior,
 * including output modalities, system instructions, generation parameters,
 * and tool integrations.
 *
 * @since 0.1.0
 *
 * @phpstan-import-type FunctionDeclarationArrayShape from FunctionDeclaration
 * @phpstan-import-type WebSearchArrayShape from WebSearch
 *
 * @phpstan-type ModelConfigArrayShape array{
 *     outputModalities?: list&lt;string&gt;,
 *     systemInstruction?: string,
 *     candidateCount?: int,
 *     maxTokens?: int,
 *     temperature?: float,
 *     topP?: float,
 *     topK?: int,
 *     stopSequences?: list&lt;string&gt;,
 *     presencePenalty?: float,
 *     frequencyPenalty?: float,
 *     logprobs?: bool,
 *     topLogprobs?: int,
 *     functionDeclarations?: list&lt;FunctionDeclarationArrayShape&gt;,
 *     webSearch?: WebSearchArrayShape,
 *     outputFileType?: string,
 *     outputMimeType?: string,
 *     outputSchema?: array&lt;string, mixed&gt;,
 *     outputMediaOrientation?: string,
 *     outputMediaAspectRatio?: string,
 *     outputSpeechVoice?: string,
 *     customOptions?: array&lt;string, mixed&gt;
 * }
 *
 * @extends AbstractDataTransferObject&lt;ModelConfigArrayShape&gt;
 */
class ModelConfig extends AbstractDataTransferObject
{
    public const KEY_OUTPUT_MODALITIES = &#039;outputModalities&#039;;
    public const KEY_SYSTEM_INSTRUCTION = &#039;systemInstruction&#039;;
    public const KEY_CANDIDATE_COUNT = &#039;candidateCount&#039;;
    public const KEY_MAX_TOKENS = &#039;maxTokens&#039;;
    public const KEY_TEMPERATURE = &#039;temperature&#039;;
    public const KEY_TOP_P = &#039;topP&#039;;
    public const KEY_TOP_K = &#039;topK&#039;;
    public const KEY_STOP_SEQUENCES = &#039;stopSequences&#039;;
    public const KEY_PRESENCE_PENALTY = &#039;presencePenalty&#039;;
    public const KEY_FREQUENCY_PENALTY = &#039;frequencyPenalty&#039;;
    public const KEY_LOGPROBS = &#039;logprobs&#039;;
    public const KEY_TOP_LOGPROBS = &#039;topLogprobs&#039;;
    public const KEY_FUNCTION_DECLARATIONS = &#039;functionDeclarations&#039;;
    public const KEY_WEB_SEARCH = &#039;webSearch&#039;;
    public const KEY_OUTPUT_FILE_TYPE = &#039;outputFileType&#039;;
    public const KEY_OUTPUT_MIME_TYPE = &#039;outputMimeType&#039;;
    public const KEY_OUTPUT_SCHEMA = &#039;outputSchema&#039;;
    public const KEY_OUTPUT_MEDIA_ORIENTATION = &#039;outputMediaOrientation&#039;;
    public const KEY_OUTPUT_MEDIA_ASPECT_RATIO = &#039;outputMediaAspectRatio&#039;;
    public const KEY_OUTPUT_SPEECH_VOICE = &#039;outputSpeechVoice&#039;;
    public const KEY_CUSTOM_OPTIONS = &#039;customOptions&#039;;
    /*
     * Note: This key is not an actual model config key, but specified here for convenience.
     * It is relevant for model discovery, to determine which models support which input modalities.
     * The actual input modalities are part of the message sent to the model, not the model config.
     */
    public const KEY_INPUT_MODALITIES = &#039;inputModalities&#039;;
    /**
     * @var list&lt;ModalityEnum&gt;|null Output modalities for the model.
     */
    protected ?array $outputModalities = null;
    /**
     * @var string|null System instruction for the model.
     */
    protected ?string $systemInstruction = null;
    /**
     * @var int|null Number of response candidates to generate.
     */
    protected ?int $candidateCount = null;
    /**
     * @var int|null Maximum number of tokens to generate.
     */
    protected ?int $maxTokens = null;
    /**
     * @var float|null Temperature for randomness (0.0 to 2.0).
     */
    protected ?float $temperature = null;
    /**
     * @var float|null Top-p nucleus sampling parameter.
     */
    protected ?float $topP = null;
    /**
     * @var int|null Top-k sampling parameter.
     */
    protected ?int $topK = null;
    /**
     * @var list&lt;string&gt;|null Stop sequences.
     */
    protected ?array $stopSequences = null;
    /**
     * @var float|null Presence penalty for reducing repetition.
     */
    protected ?float $presencePenalty = null;
    /**
     * @var float|null Frequency penalty for reducing repetition.
     */
    protected ?float $frequencyPenalty = null;
    /**
     * @var bool|null Whether to return log probabilities.
     */
    protected ?bool $logprobs = null;
    /**
     * @var int|null Number of top log probabilities to return.
     */
    protected ?int $topLogprobs = null;
    /**
     * @var list&lt;FunctionDeclaration&gt;|null Function declarations available to the model.
     */
    protected ?array $functionDeclarations = null;
    /**
     * @var WebSearch|null Web search configuration for the model.
     */
    protected ?WebSearch $webSearch = null;
    /**
     * @var FileTypeEnum|null Output file type.
     */
    protected ?FileTypeEnum $outputFileType = null;
    /**
     * @var string|null Output MIME type.
     */
    protected ?string $outputMimeType = null;
    /**
     * @var array&lt;string, mixed&gt;|null Output schema (JSON schema).
     */
    protected ?array $outputSchema = null;
    /**
     * @var MediaOrientationEnum|null Output media orientation.
     */
    protected ?MediaOrientationEnum $outputMediaOrientation = null;
    /**
     * @var string|null Output media aspect ratio (e.g. 3:2, 16:9).
     */
    protected ?string $outputMediaAspectRatio = null;
    /**
     * @var string|null Output speech voice.
     */
    protected ?string $outputSpeechVoice = null;
    /**
     * @var array&lt;string, mixed&gt; Custom provider-specific options.
     */
    protected array $customOptions = [];
    /**
     * Creates a deep clone of this configuration.
     *
     * Clones nested objects (functionDeclarations, webSearch) to ensure
     * the cloned configuration is independent of the original.
     * Enum value objects (outputModalities, outputFileType, outputMediaOrientation)
     * are intentionally shared as they are immutable.
     *
     * @since 0.4.2
     */
    public function __clone()
    {
        // Deep clone function declarations if set
        if ($this-&gt;functionDeclarations !== null) {
            $clonedDeclarations = [];
            foreach ($this-&gt;functionDeclarations as $declaration) {
                $clonedDeclarations[] = clone $declaration;
            }
            $this-&gt;functionDeclarations = $clonedDeclarations;
        }
        // Clone web search if set
        if ($this-&gt;webSearch !== null) {
            $this-&gt;webSearch = clone $this-&gt;webSearch;
        }
        // Note: Enum value objects (outputModalities, outputFileType, outputMediaOrientation)
        // are immutable and can be safely shared.
    }
    /**
     * Sets the output modalities.
     *
     * @since 0.1.0
     *
     * @param list&lt;ModalityEnum&gt; $outputModalities The output modalities.
     *
     * @throws InvalidArgumentException If the array is not a list.
     */
    public function setOutputModalities(array $outputModalities): void
    {
        if (!array_is_list($outputModalities)) {
            throw new InvalidArgumentException(&#039;Output modalities must be a list array.&#039;);
        }
        $this-&gt;outputModalities = $outputModalities;
    }
    /**
     * Gets the output modalities.
     *
     * @since 0.1.0
     *
     * @return list&lt;ModalityEnum&gt;|null The output modalities.
     */
    public function getOutputModalities(): ?array
    {
        return $this-&gt;outputModalities;
    }
    /**
     * Sets the system instruction.
     *
     * @since 0.1.0
     *
     * @param string $systemInstruction The system instruction.
     */
    public function setSystemInstruction(string $systemInstruction): void
    {
        $this-&gt;systemInstruction = $systemInstruction;
    }
    /**
     * Gets the system instruction.
     *
     * @since 0.1.0
     *
     * @return string|null The system instruction.
     */
    public function getSystemInstruction(): ?string
    {
        return $this-&gt;systemInstruction;
    }
    /**
     * Sets the candidate count.
     *
     * @since 0.1.0
     *
     * @param int $candidateCount The candidate count.
     */
    public function setCandidateCount(int $candidateCount): void
    {
        $this-&gt;candidateCount = $candidateCount;
    }
    /**
     * Gets the candidate count.
     *
     * @since 0.1.0
     *
     * @return int|null The candidate count.
     */
    public function getCandidateCount(): ?int
    {
        return $this-&gt;candidateCount;
    }
    /**
     * Sets the maximum tokens.
     *
     * @since 0.1.0
     *
     * @param int $maxTokens The maximum tokens.
     */
    public function setMaxTokens(int $maxTokens): void
    {
        $this-&gt;maxTokens = $maxTokens;
    }
    /**
     * Gets the maximum tokens.
     *
     * @since 0.1.0
     *
     * @return int|null The maximum tokens.
     */
    public function getMaxTokens(): ?int
    {
        return $this-&gt;maxTokens;
    }
    /**
     * Sets the temperature.
     *
     * @since 0.1.0
     *
     * @param float $temperature The temperature.
     */
    public function setTemperature(float $temperature): void
    {
        $this-&gt;temperature = $temperature;
    }
    /**
     * Gets the temperature.
     *
     * @since 0.1.0
     *
     * @return float|null The temperature.
     */
    public function getTemperature(): ?float
    {
        return $this-&gt;temperature;
    }
    /**
     * Sets the top-p parameter.
     *
     * @since 0.1.0
     *
     * @param float $topP The top-p parameter.
     */
    public function setTopP(float $topP): void
    {
        $this-&gt;topP = $topP;
    }
    /**
     * Gets the top-p parameter.
     *
     * @since 0.1.0
     *
     * @return float|null The top-p parameter.
     */
    public function getTopP(): ?float
    {
        return $this-&gt;topP;
    }
    /**
     * Sets the top-k parameter.
     *
     * @since 0.1.0
     *
     * @param int $topK The top-k parameter.
     */
    public function setTopK(int $topK): void
    {
        $this-&gt;topK = $topK;
    }
    /**
     * Gets the top-k parameter.
     *
     * @since 0.1.0
     *
     * @return int|null The top-k parameter.
     */
    public function getTopK(): ?int
    {
        return $this-&gt;topK;
    }
    /**
     * Sets the stop sequences.
     *
     * @since 0.1.0
     *
     * @param list&lt;string&gt; $stopSequences The stop sequences.
     *
     * @throws InvalidArgumentException If the array is not a list.
     */
    public function setStopSequences(array $stopSequences): void
    {
        if (!array_is_list($stopSequences)) {
            throw new InvalidArgumentException(&#039;Stop sequences must be a list array.&#039;);
        }
        $this-&gt;stopSequences = $stopSequences;
    }
    /**
     * Gets the stop sequences.
     *
     * @since 0.1.0
     *
     * @return list&lt;string&gt;|null The stop sequences.
     */
    public function getStopSequences(): ?array
    {
        return $this-&gt;stopSequences;
    }
    /**
     * Sets the presence penalty.
     *
     * @since 0.1.0
     *
     * @param float $presencePenalty The presence penalty.
     */
    public function setPresencePenalty(float $presencePenalty): void
    {
        $this-&gt;presencePenalty = $presencePenalty;
    }
    /**
     * Gets the presence penalty.
     *
     * @since 0.1.0
     *
     * @return float|null The presence penalty.
     */
    public function getPresencePenalty(): ?float
    {
        return $this-&gt;presencePenalty;
    }
    /**
     * Sets the frequency penalty.
     *
     * @since 0.1.0
     *
     * @param float $frequencyPenalty The frequency penalty.
     */
    public function setFrequencyPenalty(float $frequencyPenalty): void
    {
        $this-&gt;frequencyPenalty = $frequencyPenalty;
    }
    /**
     * Gets the frequency penalty.
     *
     * @since 0.1.0
     *
     * @return float|null The frequency penalty.
     */
    public function getFrequencyPenalty(): ?float
    {
        return $this-&gt;frequencyPenalty;
    }
    /**
     * Sets whether to return log probabilities.
     *
     * @since 0.1.0
     *
     * @param bool $logprobs Whether to return log probabilities.
     */
    public function setLogprobs(bool $logprobs): void
    {
        $this-&gt;logprobs = $logprobs;
    }
    /**
     * Gets whether to return log probabilities.
     *
     * @since 0.1.0
     *
     * @return bool|null Whether to return log probabilities.
     */
    public function getLogprobs(): ?bool
    {
        return $this-&gt;logprobs;
    }
    /**
     * Sets the number of top log probabilities to return.
     *
     * @since 0.1.0
     *
     * @param int $topLogprobs The number of top log probabilities.
     */
    public function setTopLogprobs(int $topLogprobs): void
    {
        $this-&gt;topLogprobs = $topLogprobs;
    }
    /**
     * Gets the number of top log probabilities to return.
     *
     * @since 0.1.0
     *
     * @return int|null The number of top log probabilities.
     */
    public function getTopLogprobs(): ?int
    {
        return $this-&gt;topLogprobs;
    }
    /**
     * Sets the function declarations.
     *
     * @since 0.1.0
     *
     * @param list&lt;FunctionDeclaration&gt; $functionDeclarations The function declarations.
     *
     * @throws InvalidArgumentException If the array is not a list.
     */
    public function setFunctionDeclarations(array $functionDeclarations): void
    {
        if (!array_is_list($functionDeclarations)) {
            throw new InvalidArgumentException(&#039;Function declarations must be a list array.&#039;);
        }
        $this-&gt;functionDeclarations = $functionDeclarations;
    }
    /**
     * Gets the function declarations.
     *
     * @since 0.1.0
     *
     * @return list&lt;FunctionDeclaration&gt;|null The function declarations.
     */
    public function getFunctionDeclarations(): ?array
    {
        return $this-&gt;functionDeclarations;
    }
    /**
     * Sets the web search configuration.
     *
     * @since 0.1.0
     *
     * @param WebSearch $webSearch The web search configuration.
     */
    public function setWebSearch(WebSearch $webSearch): void
    {
        $this-&gt;webSearch = $webSearch;
    }
    /**
     * Gets the web search configuration.
     *
     * @since 0.1.0
     *
     * @return WebSearch|null The web search configuration.
     */
    public function getWebSearch(): ?WebSearch
    {
        return $this-&gt;webSearch;
    }
    /**
     * Sets the output file type.
     *
     * @since 0.1.0
     *
     * @param FileTypeEnum $outputFileType The output file type.
     */
    public function setOutputFileType(FileTypeEnum $outputFileType): void
    {
        $this-&gt;outputFileType = $outputFileType;
    }
    /**
     * Gets the output file type.
     *
     * @since 0.1.0
     *
     * @return FileTypeEnum|null The output file type.
     */
    public function getOutputFileType(): ?FileTypeEnum
    {
        return $this-&gt;outputFileType;
    }
    /**
     * Sets the output MIME type.
     *
     * @since 0.1.0
     *
     * @param string $outputMimeType The output MIME type.
     */
    public function setOutputMimeType(string $outputMimeType): void
    {
        $this-&gt;outputMimeType = $outputMimeType;
    }
    /**
     * Gets the output MIME type.
     *
     * @since 0.1.0
     *
     * @return string|null The output MIME type.
     */
    public function getOutputMimeType(): ?string
    {
        return $this-&gt;outputMimeType;
    }
    /**
     * Sets the output schema.
     *
     * When setting an output schema, this method automatically sets
     * the output MIME type to &quot;application/json&quot; if not already set.
     *
     * @since 0.1.0
     *
     * @param array&lt;string, mixed&gt; $outputSchema The output schema (JSON schema).
     */
    public function setOutputSchema(array $outputSchema): void
    {
        $this-&gt;outputSchema = $outputSchema;
        // Automatically set outputMimeType to application/json when schema is provided
        if ($this-&gt;outputMimeType === null) {
            $this-&gt;outputMimeType = &#039;application/json&#039;;
        }
    }
    /**
     * Gets the output schema.
     *
     * @since 0.1.0
     *
     * @return array&lt;string, mixed&gt;|null The output schema.
     */
    public function getOutputSchema(): ?array
    {
        return $this-&gt;outputSchema;
    }
    /**
     * Sets the output media orientation.
     *
     * @since 0.1.0
     *
     * @param MediaOrientationEnum $outputMediaOrientation The output media orientation.
     */
    public function setOutputMediaOrientation(MediaOrientationEnum $outputMediaOrientation): void
    {
        if ($this-&gt;outputMediaAspectRatio) {
            $this-&gt;validateMediaOrientationAspectRatioCompatibility($outputMediaOrientation, $this-&gt;outputMediaAspectRatio);
        }
        $this-&gt;outputMediaOrientation = $outputMediaOrientation;
    }
    /**
     * Gets the output media orientation.
     *
     * @since 0.1.0
     *
     * @return MediaOrientationEnum|null The output media orientation.
     */
    public function getOutputMediaOrientation(): ?MediaOrientationEnum
    {
        return $this-&gt;outputMediaOrientation;
    }
    /**
     * Sets the output media aspect ratio.
     *
     * If set, this supersedes the output media orientation, as it is a more specific configuration.
     *
     * @since 0.1.0
     *
     * @param string $outputMediaAspectRatio The output media aspect ratio (e.g. 3:2, 16:9).
     */
    public function setOutputMediaAspectRatio(string $outputMediaAspectRatio): void
    {
        if (!preg_match(&#039;/^\d+:\d+$/&#039;, $outputMediaAspectRatio)) {
            throw new InvalidArgumentException(&#039;Output media aspect ratio must be in the format &quot;width:height&quot; (e.g. 3:2, 16:9).&#039;);
        }
        if ($this-&gt;outputMediaOrientation) {
            $this-&gt;validateMediaOrientationAspectRatioCompatibility($this-&gt;outputMediaOrientation, $outputMediaAspectRatio);
        }
        $this-&gt;outputMediaAspectRatio = $outputMediaAspectRatio;
    }
    /**
     * Gets the output media aspect ratio.
     *
     * @since 0.1.0
     *
     * @return string|null The output media aspect ratio (e.g. 3:2, 16:9).
     */
    public function getOutputMediaAspectRatio(): ?string
    {
        return $this-&gt;outputMediaAspectRatio;
    }
    /**
     * Validates that the given media orientation and aspect ratio values do not conflict with each other.
     *
     * @since 0.4.0
     *
     * @param MediaOrientationEnum $orientation The desired media orientation.
     * @param string $aspectRatio The desired media aspect ratio.
     */
    protected function validateMediaOrientationAspectRatioCompatibility(MediaOrientationEnum $orientation, string $aspectRatio): void
    {
        $aspectRatioParts = explode(&#039;:&#039;, $aspectRatio);
        if ($orientation-&gt;isSquare() &amp;&amp; $aspectRatioParts[0] !== $aspectRatioParts[1]) {
            throw new InvalidArgumentException(&#039;The aspect ratio &quot;&#039; . $aspectRatio . &#039;&quot; is not compatible with the square orientation.&#039;);
        }
        if ($orientation-&gt;isLandscape() &amp;&amp; $aspectRatioParts[0] &lt;= $aspectRatioParts[1]) {
            throw new InvalidArgumentException(&#039;The aspect ratio &quot;&#039; . $aspectRatio . &#039;&quot; is not compatible with the landscape orientation.&#039;);
        }
        if ($orientation-&gt;isPortrait() &amp;&amp; $aspectRatioParts[0] &gt;= $aspectRatioParts[1]) {
            throw new InvalidArgumentException(&#039;The aspect ratio &quot;&#039; . $aspectRatio . &#039;&quot; is not compatible with the portrait orientation.&#039;);
        }
    }
    /**
     * Sets the output speech voice.
     *
     * @since 0.1.0
     *
     * @param string $outputSpeechVoice The output speech voice.
     */
    public function setOutputSpeechVoice(string $outputSpeechVoice): void
    {
        $this-&gt;outputSpeechVoice = $outputSpeechVoice;
    }
    /**
     * Gets the output speech voice.
     *
     * @since 0.1.0
     *
     * @return string|null The output speech voice.
     */
    public function getOutputSpeechVoice(): ?string
    {
        return $this-&gt;outputSpeechVoice;
    }
    /**
     * Sets a single custom option.
     *
     * @since 0.1.0
     *
     * @param string $key   The option key.
     * @param mixed  $value The option value.
     */
    public function setCustomOption(string $key, $value): void
    {
        $this-&gt;customOptions[$key] = $value;
    }
    /**
     * Sets the custom options.
     *
     * @since 0.1.0
     *
     * @param array&lt;string, mixed&gt; $customOptions The custom options.
     */
    public function setCustomOptions(array $customOptions): void
    {
        $this-&gt;customOptions = $customOptions;
    }
    /**
     * Gets the custom options.
     *
     * @since 0.1.0
     *
     * @return array&lt;string, mixed&gt; The custom options.
     */
    public function getCustomOptions(): array
    {
        return $this-&gt;customOptions;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function getJsonSchema(): array
    {
        return [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_OUTPUT_MODALITIES =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;enum&#039; =&gt; ModalityEnum::getValues()], &#039;description&#039; =&gt; &#039;Output modalities for the model.&#039;], self::KEY_SYSTEM_INSTRUCTION =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;System instruction for the model.&#039;], self::KEY_CANDIDATE_COUNT =&gt; [&#039;type&#039; =&gt; &#039;integer&#039;, &#039;minimum&#039; =&gt; 1, &#039;description&#039; =&gt; &#039;Number of response candidates to generate.&#039;], self::KEY_MAX_TOKENS =&gt; [&#039;type&#039; =&gt; &#039;integer&#039;, &#039;minimum&#039; =&gt; 1, &#039;description&#039; =&gt; &#039;Maximum number of tokens to generate.&#039;], self::KEY_TEMPERATURE =&gt; [&#039;type&#039; =&gt; &#039;number&#039;, &#039;minimum&#039; =&gt; 0.0, &#039;maximum&#039; =&gt; 2.0, &#039;description&#039; =&gt; &#039;Temperature for randomness.&#039;], self::KEY_TOP_P =&gt; [&#039;type&#039; =&gt; &#039;number&#039;, &#039;minimum&#039; =&gt; 0.0, &#039;maximum&#039; =&gt; 1.0, &#039;description&#039; =&gt; &#039;Top-p nucleus sampling parameter.&#039;], self::KEY_TOP_K =&gt; [&#039;type&#039; =&gt; &#039;integer&#039;, &#039;minimum&#039; =&gt; 1, &#039;description&#039; =&gt; &#039;Top-k sampling parameter.&#039;], self::KEY_STOP_SEQUENCES =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; [&#039;type&#039; =&gt; &#039;string&#039;], &#039;description&#039; =&gt; &#039;Stop sequences.&#039;], self::KEY_PRESENCE_PENALTY =&gt; [&#039;type&#039; =&gt; &#039;number&#039;, &#039;description&#039; =&gt; &#039;Presence penalty for reducing repetition.&#039;], self::KEY_FREQUENCY_PENALTY =&gt; [&#039;type&#039; =&gt; &#039;number&#039;, &#039;description&#039; =&gt; &#039;Frequency penalty for reducing repetition.&#039;], self::KEY_LOGPROBS =&gt; [&#039;type&#039; =&gt; &#039;boolean&#039;, &#039;description&#039; =&gt; &#039;Whether to return log probabilities.&#039;], self::KEY_TOP_LOGPROBS =&gt; [&#039;type&#039; =&gt; &#039;integer&#039;, &#039;minimum&#039; =&gt; 1, &#039;description&#039; =&gt; &#039;Number of top log probabilities to return.&#039;], self::KEY_FUNCTION_DECLARATIONS =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; FunctionDeclaration::getJsonSchema(), &#039;description&#039; =&gt; &#039;Function declarations available to the model.&#039;], self::KEY_WEB_SEARCH =&gt; WebSearch::getJsonSchema(), self::KEY_OUTPUT_FILE_TYPE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;enum&#039; =&gt; FileTypeEnum::getValues(), &#039;description&#039; =&gt; &#039;Output file type.&#039;], self::KEY_OUTPUT_MIME_TYPE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;Output MIME type.&#039;], self::KEY_OUTPUT_SCHEMA =&gt; [&#039;type&#039; =&gt; &#039;object&#039;, &#039;additionalProperties&#039; =&gt; \true, &#039;description&#039; =&gt; &#039;Output schema (JSON schema).&#039;], self::KEY_OUTPUT_MEDIA_ORIENTATION =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;enum&#039; =&gt; MediaOrientationEnum::getValues(), &#039;description&#039; =&gt; &#039;Output media orientation.&#039;], self::KEY_OUTPUT_MEDIA_ASPECT_RATIO =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;pattern&#039; =&gt; &#039;^\d+:\d+$&#039;, &#039;description&#039; =&gt; &#039;Output media aspect ratio.&#039;], self::KEY_OUTPUT_SPEECH_VOICE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;Output speech voice.&#039;], self::KEY_CUSTOM_OPTIONS =&gt; [&#039;type&#039; =&gt; &#039;object&#039;, &#039;additionalProperties&#039; =&gt; \true, &#039;description&#039; =&gt; &#039;Custom provider-specific options.&#039;]], &#039;additionalProperties&#039; =&gt; \false];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return ModelConfigArrayShape
     */
    public function toArray(): array
    {
        $data = [];
        if ($this-&gt;outputModalities !== null) {
            $data[self::KEY_OUTPUT_MODALITIES] = array_map(static function (ModalityEnum $modality): string {
                return $modality-&gt;value;
            }, $this-&gt;outputModalities);
        }
        if ($this-&gt;systemInstruction !== null) {
            $data[self::KEY_SYSTEM_INSTRUCTION] = $this-&gt;systemInstruction;
        }
        if ($this-&gt;candidateCount !== null) {
            $data[self::KEY_CANDIDATE_COUNT] = $this-&gt;candidateCount;
        }
        if ($this-&gt;maxTokens !== null) {
            $data[self::KEY_MAX_TOKENS] = $this-&gt;maxTokens;
        }
        if ($this-&gt;temperature !== null) {
            $data[self::KEY_TEMPERATURE] = $this-&gt;temperature;
        }
        if ($this-&gt;topP !== null) {
            $data[self::KEY_TOP_P] = $this-&gt;topP;
        }
        if ($this-&gt;topK !== null) {
            $data[self::KEY_TOP_K] = $this-&gt;topK;
        }
        if ($this-&gt;stopSequences !== null) {
            $data[self::KEY_STOP_SEQUENCES] = $this-&gt;stopSequences;
        }
        if ($this-&gt;presencePenalty !== null) {
            $data[self::KEY_PRESENCE_PENALTY] = $this-&gt;presencePenalty;
        }
        if ($this-&gt;frequencyPenalty !== null) {
            $data[self::KEY_FREQUENCY_PENALTY] = $this-&gt;frequencyPenalty;
        }
        if ($this-&gt;logprobs !== null) {
            $data[self::KEY_LOGPROBS] = $this-&gt;logprobs;
        }
        if ($this-&gt;topLogprobs !== null) {
            $data[self::KEY_TOP_LOGPROBS] = $this-&gt;topLogprobs;
        }
        if ($this-&gt;functionDeclarations !== null) {
            $data[self::KEY_FUNCTION_DECLARATIONS] = array_map(static function (FunctionDeclaration $functionDeclaration): array {
                return $functionDeclaration-&gt;toArray();
            }, $this-&gt;functionDeclarations);
        }
        if ($this-&gt;webSearch !== null) {
            $data[self::KEY_WEB_SEARCH] = $this-&gt;webSearch-&gt;toArray();
        }
        if ($this-&gt;outputFileType !== null) {
            $data[self::KEY_OUTPUT_FILE_TYPE] = $this-&gt;outputFileType-&gt;value;
        }
        if ($this-&gt;outputMimeType !== null) {
            $data[self::KEY_OUTPUT_MIME_TYPE] = $this-&gt;outputMimeType;
        }
        if ($this-&gt;outputSchema !== null) {
            $data[self::KEY_OUTPUT_SCHEMA] = $this-&gt;outputSchema;
        }
        if ($this-&gt;outputMediaOrientation !== null) {
            $data[self::KEY_OUTPUT_MEDIA_ORIENTATION] = $this-&gt;outputMediaOrientation-&gt;value;
        }
        if ($this-&gt;outputMediaAspectRatio !== null) {
            $data[self::KEY_OUTPUT_MEDIA_ASPECT_RATIO] = $this-&gt;outputMediaAspectRatio;
        }
        if ($this-&gt;outputSpeechVoice !== null) {
            $data[self::KEY_OUTPUT_SPEECH_VOICE] = $this-&gt;outputSpeechVoice;
        }
        if (!empty($this-&gt;customOptions)) {
            $data[self::KEY_CUSTOM_OPTIONS] = $this-&gt;customOptions;
        }
        return $data;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function fromArray(array $array): self
    {
        $config = new self();
        if (isset($array[self::KEY_OUTPUT_MODALITIES])) {
            $config-&gt;setOutputModalities(array_map(static fn(string $modality): ModalityEnum =&gt; ModalityEnum::from($modality), $array[self::KEY_OUTPUT_MODALITIES]));
        }
        if (isset($array[self::KEY_SYSTEM_INSTRUCTION])) {
            $config-&gt;setSystemInstruction($array[self::KEY_SYSTEM_INSTRUCTION]);
        }
        if (isset($array[self::KEY_CANDIDATE_COUNT])) {
            $config-&gt;setCandidateCount($array[self::KEY_CANDIDATE_COUNT]);
        }
        if (isset($array[self::KEY_MAX_TOKENS])) {
            $config-&gt;setMaxTokens($array[self::KEY_MAX_TOKENS]);
        }
        if (isset($array[self::KEY_TEMPERATURE])) {
            $config-&gt;setTemperature($array[self::KEY_TEMPERATURE]);
        }
        if (isset($array[self::KEY_TOP_P])) {
            $config-&gt;setTopP($array[self::KEY_TOP_P]);
        }
        if (isset($array[self::KEY_TOP_K])) {
            $config-&gt;setTopK($array[self::KEY_TOP_K]);
        }
        if (isset($array[self::KEY_STOP_SEQUENCES])) {
            $config-&gt;setStopSequences($array[self::KEY_STOP_SEQUENCES]);
        }
        if (isset($array[self::KEY_PRESENCE_PENALTY])) {
            $config-&gt;setPresencePenalty($array[self::KEY_PRESENCE_PENALTY]);
        }
        if (isset($array[self::KEY_FREQUENCY_PENALTY])) {
            $config-&gt;setFrequencyPenalty($array[self::KEY_FREQUENCY_PENALTY]);
        }
        if (isset($array[self::KEY_LOGPROBS])) {
            $config-&gt;setLogprobs($array[self::KEY_LOGPROBS]);
        }
        if (isset($array[self::KEY_TOP_LOGPROBS])) {
            $config-&gt;setTopLogprobs($array[self::KEY_TOP_LOGPROBS]);
        }
        if (isset($array[self::KEY_FUNCTION_DECLARATIONS])) {
            $config-&gt;setFunctionDeclarations(array_map(static function (array $functionDeclarationData): FunctionDeclaration {
                return FunctionDeclaration::fromArray($functionDeclarationData);
            }, $array[self::KEY_FUNCTION_DECLARATIONS]));
        }
        if (isset($array[self::KEY_WEB_SEARCH])) {
            $config-&gt;setWebSearch(WebSearch::fromArray($array[self::KEY_WEB_SEARCH]));
        }
        if (isset($array[self::KEY_OUTPUT_FILE_TYPE])) {
            $config-&gt;setOutputFileType(FileTypeEnum::from($array[self::KEY_OUTPUT_FILE_TYPE]));
        }
        if (isset($array[self::KEY_OUTPUT_MIME_TYPE])) {
            $config-&gt;setOutputMimeType($array[self::KEY_OUTPUT_MIME_TYPE]);
        }
        if (isset($array[self::KEY_OUTPUT_SCHEMA])) {
            $config-&gt;setOutputSchema($array[self::KEY_OUTPUT_SCHEMA]);
        }
        if (isset($array[self::KEY_OUTPUT_MEDIA_ORIENTATION])) {
            $config-&gt;setOutputMediaOrientation(MediaOrientationEnum::from($array[self::KEY_OUTPUT_MEDIA_ORIENTATION]));
        }
        if (isset($array[self::KEY_OUTPUT_MEDIA_ASPECT_RATIO])) {
            $config-&gt;setOutputMediaAspectRatio($array[self::KEY_OUTPUT_MEDIA_ASPECT_RATIO]);
        }
        if (isset($array[self::KEY_OUTPUT_SPEECH_VOICE])) {
            $config-&gt;setOutputSpeechVoice($array[self::KEY_OUTPUT_SPEECH_VOICE]);
        }
        if (isset($array[self::KEY_CUSTOM_OPTIONS])) {
            $config-&gt;setCustomOptions($array[self::KEY_CUSTOM_OPTIONS]);
        }
        return $config;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FProviders%2FModels%2FDTO'>⬅ Back to Directory</a>