<h2>File Contents: /home/planet5/public_html/wp-includes/php-ai-client/src/Providers/Models/DTO/ModelMetadata.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/php-ai-client/src/Providers/Models/DTO/ModelMetadata.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\Providers\Models\Enums\CapabilityEnum;
/**
 * Represents metadata about an AI model.
 *
 * This class contains information about a specific AI model, including
 * its identifier, display name, supported capabilities, and configuration options.
 *
 * @since 0.1.0
 *
 * @phpstan-import-type SupportedOptionArrayShape from SupportedOption
 *
 * @phpstan-type ModelMetadataArrayShape array{
 *     id: string,
 *     name: string,
 *     supportedCapabilities: list&lt;string&gt;,
 *     supportedOptions: list&lt;SupportedOptionArrayShape&gt;
 * }
 *
 * @extends AbstractDataTransferObject&lt;ModelMetadataArrayShape&gt;
 */
class ModelMetadata extends AbstractDataTransferObject
{
    public const KEY_ID = &#039;id&#039;;
    public const KEY_NAME = &#039;name&#039;;
    public const KEY_SUPPORTED_CAPABILITIES = &#039;supportedCapabilities&#039;;
    public const KEY_SUPPORTED_OPTIONS = &#039;supportedOptions&#039;;
    /**
     * @var string The model&#039;s unique identifier.
     */
    protected string $id;
    /**
     * @var string The model&#039;s display name.
     */
    protected string $name;
    /**
     * @var list&lt;CapabilityEnum&gt; The model&#039;s supported capabilities.
     */
    protected array $supportedCapabilities;
    /**
     * @var list&lt;SupportedOption&gt; The model&#039;s supported configuration options.
     */
    protected array $supportedOptions;
    /**
     * Constructor.
     *
     * @since 0.1.0
     *
     * @param string $id The model&#039;s unique identifier.
     * @param string $name The model&#039;s display name.
     * @param list&lt;CapabilityEnum&gt; $supportedCapabilities The model&#039;s supported capabilities.
     * @param list&lt;SupportedOption&gt; $supportedOptions The model&#039;s supported configuration options.
     *
     * @throws InvalidArgumentException If arrays are not lists.
     */
    public function __construct(string $id, string $name, array $supportedCapabilities, array $supportedOptions)
    {
        if (!array_is_list($supportedCapabilities)) {
            throw new InvalidArgumentException(&#039;Supported capabilities must be a list array.&#039;);
        }
        if (!array_is_list($supportedOptions)) {
            throw new InvalidArgumentException(&#039;Supported options must be a list array.&#039;);
        }
        $this-&gt;id = $id;
        $this-&gt;name = $name;
        $this-&gt;supportedCapabilities = $supportedCapabilities;
        $this-&gt;supportedOptions = $supportedOptions;
    }
    /**
     * Gets the model&#039;s unique identifier.
     *
     * @since 0.1.0
     *
     * @return string The model ID.
     */
    public function getId(): string
    {
        return $this-&gt;id;
    }
    /**
     * Gets the model&#039;s display name.
     *
     * @since 0.1.0
     *
     * @return string The model name.
     */
    public function getName(): string
    {
        return $this-&gt;name;
    }
    /**
     * Gets the model&#039;s supported capabilities.
     *
     * @since 0.1.0
     *
     * @return list&lt;CapabilityEnum&gt; The supported capabilities.
     */
    public function getSupportedCapabilities(): array
    {
        return $this-&gt;supportedCapabilities;
    }
    /**
     * Gets the model&#039;s supported configuration options.
     *
     * @since 0.1.0
     *
     * @return list&lt;SupportedOption&gt; The supported options.
     */
    public function getSupportedOptions(): array
    {
        return $this-&gt;supportedOptions;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function getJsonSchema(): array
    {
        return [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_ID =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;The model\&#039;s unique identifier.&#039;], self::KEY_NAME =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;The model\&#039;s display name.&#039;], self::KEY_SUPPORTED_CAPABILITIES =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;enum&#039; =&gt; CapabilityEnum::getValues()], &#039;description&#039; =&gt; &#039;The model\&#039;s supported capabilities.&#039;], self::KEY_SUPPORTED_OPTIONS =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; \WordPress\AiClient\Providers\Models\DTO\SupportedOption::getJsonSchema(), &#039;description&#039; =&gt; &#039;The model\&#039;s supported configuration options.&#039;]], &#039;required&#039; =&gt; [self::KEY_ID, self::KEY_NAME, self::KEY_SUPPORTED_CAPABILITIES, self::KEY_SUPPORTED_OPTIONS]];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return ModelMetadataArrayShape
     */
    public function toArray(): array
    {
        return [self::KEY_ID =&gt; $this-&gt;id, self::KEY_NAME =&gt; $this-&gt;name, self::KEY_SUPPORTED_CAPABILITIES =&gt; array_map(static fn(CapabilityEnum $capability): string =&gt; $capability-&gt;value, $this-&gt;supportedCapabilities), self::KEY_SUPPORTED_OPTIONS =&gt; array_map(static fn(\WordPress\AiClient\Providers\Models\DTO\SupportedOption $option): array =&gt; $option-&gt;toArray(), $this-&gt;supportedOptions)];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function fromArray(array $array): self
    {
        static::validateFromArrayData($array, [self::KEY_ID, self::KEY_NAME, self::KEY_SUPPORTED_CAPABILITIES, self::KEY_SUPPORTED_OPTIONS]);
        return new self($array[self::KEY_ID], $array[self::KEY_NAME], array_map(static fn(string $capability): CapabilityEnum =&gt; CapabilityEnum::from($capability), $array[self::KEY_SUPPORTED_CAPABILITIES]), array_map(static fn(array $optionData): \WordPress\AiClient\Providers\Models\DTO\SupportedOption =&gt; \WordPress\AiClient\Providers\Models\DTO\SupportedOption::fromArray($optionData), $array[self::KEY_SUPPORTED_OPTIONS]));
    }
    /**
     * Performs a deep clone of the model metadata.
     *
     * This method ensures that supported option objects are cloned to prevent
     * modifications to the cloned metadata from affecting the original.
     *
     * @since 0.4.2
     */
    public function __clone()
    {
        $clonedOptions = [];
        foreach ($this-&gt;supportedOptions as $option) {
            $clonedOptions[] = clone $option;
        }
        $this-&gt;supportedOptions = $clonedOptions;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FProviders%2FModels%2FDTO'>⬅ Back to Directory</a>