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

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

use WordPress\AiClient\Common\AbstractDataTransferObject;
use WordPress\AiClient\Common\Exception\InvalidArgumentException;
use WordPress\AiClient\Messages\Enums\MessageRoleEnum;
/**
 * Represents a message in an AI conversation.
 *
 * Messages are the fundamental unit of communication with AI models,
 * containing a role and one or more parts with different content types.
 *
 * @since 0.1.0
 *
 * @phpstan-import-type MessagePartArrayShape from MessagePart
 *
 * @phpstan-type MessageArrayShape array{
 *     role: string,
 *     parts: array&lt;MessagePartArrayShape&gt;
 * }
 *
 * @extends AbstractDataTransferObject&lt;MessageArrayShape&gt;
 */
class Message extends AbstractDataTransferObject
{
    public const KEY_ROLE = &#039;role&#039;;
    public const KEY_PARTS = &#039;parts&#039;;
    /**
     * @var MessageRoleEnum The role of the message sender.
     */
    protected MessageRoleEnum $role;
    /**
     * @var MessagePart[] The parts that make up this message.
     */
    protected array $parts;
    /**
     * Constructor.
     *
     * @since 0.1.0
     *
     * @param MessageRoleEnum $role The role of the message sender.
     * @param MessagePart[] $parts The parts that make up this message.
     * @throws InvalidArgumentException If parts contain invalid content for the role.
     */
    public function __construct(MessageRoleEnum $role, array $parts)
    {
        $this-&gt;role = $role;
        $this-&gt;parts = $parts;
        $this-&gt;validateParts();
    }
    /**
     * Gets the role of the message sender.
     *
     * @since 0.1.0
     *
     * @return MessageRoleEnum The role.
     */
    public function getRole(): MessageRoleEnum
    {
        return $this-&gt;role;
    }
    /**
     * Gets the message parts.
     *
     * @since 0.1.0
     *
     * @return MessagePart[] The message parts.
     */
    public function getParts(): array
    {
        return $this-&gt;parts;
    }
    /**
     * Returns a new instance with the given part appended.
     *
     * @since 0.1.0
     *
     * @param MessagePart $part The part to append.
     * @return Message A new instance with the part appended.
     * @throws InvalidArgumentException If the part is invalid for the role.
     */
    public function withPart(\WordPress\AiClient\Messages\DTO\MessagePart $part): \WordPress\AiClient\Messages\DTO\Message
    {
        $newParts = $this-&gt;parts;
        $newParts[] = $part;
        return new \WordPress\AiClient\Messages\DTO\Message($this-&gt;role, $newParts);
    }
    /**
     * Validates that the message parts are appropriate for the message role.
     *
     * @since 0.1.0
     *
     * @return void
     * @throws InvalidArgumentException If validation fails.
     */
    private function validateParts(): void
    {
        foreach ($this-&gt;parts as $part) {
            $type = $part-&gt;getType();
            if ($this-&gt;role-&gt;isUser() &amp;&amp; $type-&gt;isFunctionCall()) {
                throw new InvalidArgumentException(&#039;User messages cannot contain function calls.&#039;);
            }
            if ($this-&gt;role-&gt;isModel() &amp;&amp; $type-&gt;isFunctionResponse()) {
                throw new InvalidArgumentException(&#039;Model messages cannot contain function responses.&#039;);
            }
        }
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function getJsonSchema(): array
    {
        return [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_ROLE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;enum&#039; =&gt; MessageRoleEnum::getValues(), &#039;description&#039; =&gt; &#039;The role of the message sender.&#039;], self::KEY_PARTS =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; \WordPress\AiClient\Messages\DTO\MessagePart::getJsonSchema(), &#039;minItems&#039; =&gt; 1, &#039;description&#039; =&gt; &#039;The parts that make up this message.&#039;]], &#039;required&#039; =&gt; [self::KEY_ROLE, self::KEY_PARTS]];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return MessageArrayShape
     */
    public function toArray(): array
    {
        return [self::KEY_ROLE =&gt; $this-&gt;role-&gt;value, self::KEY_PARTS =&gt; array_map(function (\WordPress\AiClient\Messages\DTO\MessagePart $part) {
            return $part-&gt;toArray();
        }, $this-&gt;parts)];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return self The specific message class based on the role.
     */
    final public static function fromArray(array $array): self
    {
        static::validateFromArrayData($array, [self::KEY_ROLE, self::KEY_PARTS]);
        $role = MessageRoleEnum::from($array[self::KEY_ROLE]);
        $partsData = $array[self::KEY_PARTS];
        $parts = array_map(function (array $partData) {
            return \WordPress\AiClient\Messages\DTO\MessagePart::fromArray($partData);
        }, $partsData);
        // Determine which concrete class to instantiate based on role
        if ($role-&gt;isUser()) {
            return new \WordPress\AiClient\Messages\DTO\UserMessage($parts);
        } elseif ($role-&gt;isModel()) {
            return new \WordPress\AiClient\Messages\DTO\ModelMessage($parts);
        } else {
            // Only USER and MODEL roles are supported
            throw new InvalidArgumentException(&#039;Invalid message role: &#039; . $role-&gt;value);
        }
    }
    /**
     * Performs a deep clone of the message.
     *
     * This method ensures that message part objects are cloned to prevent
     * modifications to the cloned message from affecting the original.
     *
     * @since 0.4.2
     */
    public function __clone()
    {
        $clonedParts = [];
        foreach ($this-&gt;parts as $part) {
            $clonedParts[] = clone $part;
        }
        $this-&gt;parts = $clonedParts;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FMessages%2FDTO'>⬅ Back to Directory</a>