<h2>File Contents: /home/planet5/www/yogitonics.com/wp-includes/php-ai-client/src/Messages/DTO/MessagePart.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/yogitonics.com/wp-includes/php-ai-client/src/Messages/DTO/MessagePart.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\Common\Exception\RuntimeException;
use WordPress\AiClient\Files\DTO\File;
use WordPress\AiClient\Messages\Enums\MessagePartChannelEnum;
use WordPress\AiClient\Messages\Enums\MessagePartTypeEnum;
use WordPress\AiClient\Tools\DTO\FunctionCall;
use WordPress\AiClient\Tools\DTO\FunctionResponse;
/**
 * Represents a part of a message.
 *
 * Messages can contain multiple parts of different types, such as text, files,
 * function calls, etc. This DTO encapsulates one such part.
 *
 * @since 0.1.0
 *
 * @phpstan-import-type FileArrayShape from File
 * @phpstan-import-type FunctionCallArrayShape from FunctionCall
 * @phpstan-import-type FunctionResponseArrayShape from FunctionResponse
 *
 * @phpstan-type MessagePartArrayShape array{
 *     channel: string,
 *     type: string,
 *     thoughtSignature?: string,
 *     text?: string,
 *     file?: FileArrayShape,
 *     functionCall?: FunctionCallArrayShape,
 *     functionResponse?: FunctionResponseArrayShape
 * }
 *
 * @extends AbstractDataTransferObject&lt;MessagePartArrayShape&gt;
 */
class MessagePart extends AbstractDataTransferObject
{
    public const KEY_CHANNEL = &#039;channel&#039;;
    public const KEY_TYPE = &#039;type&#039;;
    public const KEY_THOUGHT_SIGNATURE = &#039;thoughtSignature&#039;;
    public const KEY_TEXT = &#039;text&#039;;
    public const KEY_FILE = &#039;file&#039;;
    public const KEY_FUNCTION_CALL = &#039;functionCall&#039;;
    public const KEY_FUNCTION_RESPONSE = &#039;functionResponse&#039;;
    /**
     * @var MessagePartChannelEnum The channel this message part belongs to.
     */
    private MessagePartChannelEnum $channel;
    /**
     * @var MessagePartTypeEnum The type of this message part.
     */
    private MessagePartTypeEnum $type;
    /**
     * @var string|null Thought signature for extended thinking.
     */
    private ?string $thoughtSignature = null;
    /**
     * @var string|null Text content (when type is TEXT).
     */
    private ?string $text = null;
    /**
     * @var File|null File data (when type is FILE).
     */
    private ?File $file = null;
    /**
     * @var FunctionCall|null Function call request (when type is FUNCTION_CALL).
     */
    private ?FunctionCall $functionCall = null;
    /**
     * @var FunctionResponse|null Function response (when type is FUNCTION_RESPONSE).
     */
    private ?FunctionResponse $functionResponse = null;
    /**
     * Constructor that accepts various content types and infers the message part type.
     *
     * @since 0.1.0
     *
     * @param mixed $content The content of this message part.
     * @param MessagePartChannelEnum|null $channel The channel this part belongs to. Defaults to CONTENT.
     * @param string|null $thoughtSignature Optional thought signature for extended thinking.
     * @throws InvalidArgumentException If an unsupported content type is provided.
     */
    public function __construct($content, ?MessagePartChannelEnum $channel = null, ?string $thoughtSignature = null)
    {
        $this-&gt;channel = $channel ?? MessagePartChannelEnum::content();
        $this-&gt;thoughtSignature = $thoughtSignature;
        if (is_string($content)) {
            $this-&gt;type = MessagePartTypeEnum::text();
            $this-&gt;text = $content;
        } elseif ($content instanceof File) {
            $this-&gt;type = MessagePartTypeEnum::file();
            $this-&gt;file = $content;
        } elseif ($content instanceof FunctionCall) {
            $this-&gt;type = MessagePartTypeEnum::functionCall();
            $this-&gt;functionCall = $content;
        } elseif ($content instanceof FunctionResponse) {
            $this-&gt;type = MessagePartTypeEnum::functionResponse();
            $this-&gt;functionResponse = $content;
        } else {
            $type = is_object($content) ? get_class($content) : gettype($content);
            throw new InvalidArgumentException(sprintf(&#039;Unsupported content type %s. Expected string, File, &#039; . &#039;FunctionCall, or FunctionResponse.&#039;, $type));
        }
    }
    /**
     * Gets the channel this message part belongs to.
     *
     * @since 0.1.0
     *
     * @return MessagePartChannelEnum The channel.
     */
    public function getChannel(): MessagePartChannelEnum
    {
        return $this-&gt;channel;
    }
    /**
     * Gets the type of this message part.
     *
     * @since 0.1.0
     *
     * @return MessagePartTypeEnum The type.
     */
    public function getType(): MessagePartTypeEnum
    {
        return $this-&gt;type;
    }
    /**
     * Gets the thought signature.
     *
     * @since 1.3.0
     *
     * @return string|null The thought signature or null if not set.
     */
    public function getThoughtSignature(): ?string
    {
        return $this-&gt;thoughtSignature;
    }
    /**
     * Gets the text content.
     *
     * @since 0.1.0
     *
     * @return string|null The text content or null if not a text part.
     */
    public function getText(): ?string
    {
        return $this-&gt;text;
    }
    /**
     * Gets the file.
     *
     * @since 0.1.0
     *
     * @return File|null The file or null if not a file part.
     */
    public function getFile(): ?File
    {
        return $this-&gt;file;
    }
    /**
     * Gets the function call.
     *
     * @since 0.1.0
     *
     * @return FunctionCall|null The function call or null if not a function call part.
     */
    public function getFunctionCall(): ?FunctionCall
    {
        return $this-&gt;functionCall;
    }
    /**
     * Gets the function response.
     *
     * @since 0.1.0
     *
     * @return FunctionResponse|null The function response or null if not a function response part.
     */
    public function getFunctionResponse(): ?FunctionResponse
    {
        return $this-&gt;functionResponse;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function getJsonSchema(): array
    {
        $channelSchema = [&#039;type&#039; =&gt; &#039;string&#039;, &#039;enum&#039; =&gt; MessagePartChannelEnum::getValues(), &#039;description&#039; =&gt; &#039;The channel this message part belongs to.&#039;];
        $thoughtSignatureSchema = [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;Thought signature for extended thinking.&#039;];
        return [&#039;oneOf&#039; =&gt; [[&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_CHANNEL =&gt; $channelSchema, self::KEY_TYPE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;const&#039; =&gt; MessagePartTypeEnum::text()-&gt;value], self::KEY_TEXT =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;Text content.&#039;], self::KEY_THOUGHT_SIGNATURE =&gt; $thoughtSignatureSchema], &#039;required&#039; =&gt; [self::KEY_TYPE, self::KEY_TEXT], &#039;additionalProperties&#039; =&gt; \false], [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_CHANNEL =&gt; $channelSchema, self::KEY_TYPE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;const&#039; =&gt; MessagePartTypeEnum::file()-&gt;value], self::KEY_FILE =&gt; File::getJsonSchema(), self::KEY_THOUGHT_SIGNATURE =&gt; $thoughtSignatureSchema], &#039;required&#039; =&gt; [self::KEY_TYPE, self::KEY_FILE], &#039;additionalProperties&#039; =&gt; \false], [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_CHANNEL =&gt; $channelSchema, self::KEY_TYPE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;const&#039; =&gt; MessagePartTypeEnum::functionCall()-&gt;value], self::KEY_FUNCTION_CALL =&gt; FunctionCall::getJsonSchema(), self::KEY_THOUGHT_SIGNATURE =&gt; $thoughtSignatureSchema], &#039;required&#039; =&gt; [self::KEY_TYPE, self::KEY_FUNCTION_CALL], &#039;additionalProperties&#039; =&gt; \false], [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_CHANNEL =&gt; $channelSchema, self::KEY_TYPE =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;const&#039; =&gt; MessagePartTypeEnum::functionResponse()-&gt;value], self::KEY_FUNCTION_RESPONSE =&gt; FunctionResponse::getJsonSchema(), self::KEY_THOUGHT_SIGNATURE =&gt; $thoughtSignatureSchema], &#039;required&#039; =&gt; [self::KEY_TYPE, self::KEY_FUNCTION_RESPONSE], &#039;additionalProperties&#039; =&gt; \false]]];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return MessagePartArrayShape
     */
    public function toArray(): array
    {
        $data = [self::KEY_CHANNEL =&gt; $this-&gt;channel-&gt;value, self::KEY_TYPE =&gt; $this-&gt;type-&gt;value];
        if ($this-&gt;text !== null) {
            $data[self::KEY_TEXT] = $this-&gt;text;
        } elseif ($this-&gt;file !== null) {
            $data[self::KEY_FILE] = $this-&gt;file-&gt;toArray();
        } elseif ($this-&gt;functionCall !== null) {
            $data[self::KEY_FUNCTION_CALL] = $this-&gt;functionCall-&gt;toArray();
        } elseif ($this-&gt;functionResponse !== null) {
            $data[self::KEY_FUNCTION_RESPONSE] = $this-&gt;functionResponse-&gt;toArray();
        } else {
            throw new RuntimeException(&#039;MessagePart requires one of: text, file, functionCall, or functionResponse. &#039; . &#039;This should not be a possible condition.&#039;);
        }
        if ($this-&gt;thoughtSignature !== null) {
            $data[self::KEY_THOUGHT_SIGNATURE] = $this-&gt;thoughtSignature;
        }
        return $data;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function fromArray(array $array): self
    {
        if (isset($array[self::KEY_CHANNEL])) {
            $channel = MessagePartChannelEnum::from($array[self::KEY_CHANNEL]);
        } else {
            $channel = null;
        }
        $thoughtSignature = $array[self::KEY_THOUGHT_SIGNATURE] ?? null;
        // Check which properties are set to determine how to construct the MessagePart
        if (isset($array[self::KEY_TEXT])) {
            return new self($array[self::KEY_TEXT], $channel, $thoughtSignature);
        } elseif (isset($array[self::KEY_FILE])) {
            return new self(File::fromArray($array[self::KEY_FILE]), $channel, $thoughtSignature);
        } elseif (isset($array[self::KEY_FUNCTION_CALL])) {
            return new self(FunctionCall::fromArray($array[self::KEY_FUNCTION_CALL]), $channel, $thoughtSignature);
        } elseif (isset($array[self::KEY_FUNCTION_RESPONSE])) {
            return new self(FunctionResponse::fromArray($array[self::KEY_FUNCTION_RESPONSE]), $channel, $thoughtSignature);
        } else {
            throw new InvalidArgumentException(&#039;MessagePart requires one of: text, file, functionCall, or functionResponse.&#039;);
        }
    }
    /**
     * Performs a deep clone of the message part.
     *
     * This method ensures that nested objects (file, function call, function response)
     * are cloned to prevent modifications to the cloned part from affecting the original.
     *
     * @since 0.4.2
     */
    public function __clone()
    {
        if ($this-&gt;file !== null) {
            $this-&gt;file = clone $this-&gt;file;
        }
        if ($this-&gt;functionCall !== null) {
            $this-&gt;functionCall = clone $this-&gt;functionCall;
        }
        if ($this-&gt;functionResponse !== null) {
            $this-&gt;functionResponse = clone $this-&gt;functionResponse;
        }
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyogitonics.com%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FMessages%2FDTO'>⬅ Back to Directory</a>