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

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

use WordPress\AiClient\Common\AbstractDataTransferObject;
use WordPress\AiClient\Common\Exception\InvalidArgumentException;
/**
 * Represents a function call request from an AI model.
 *
 * This DTO encapsulates information about a function that the AI model
 * wants to invoke, including the function name and its arguments.
 *
 * @since 0.1.0
 *
 * @phpstan-type FunctionCallArrayShape array{id?: string, name?: string, args?: mixed}
 *
 * @extends AbstractDataTransferObject&lt;FunctionCallArrayShape&gt;
 */
class FunctionCall extends AbstractDataTransferObject
{
    public const KEY_ID = &#039;id&#039;;
    public const KEY_NAME = &#039;name&#039;;
    public const KEY_ARGS = &#039;args&#039;;
    /**
     * @var string|null Unique identifier for this function call.
     */
    private ?string $id;
    /**
     * @var string|null The name of the function to call.
     */
    private ?string $name;
    /**
     * @var mixed The arguments to pass to the function.
     */
    private $args;
    /**
     * Constructor.
     *
     * @since 0.1.0
     *
     * @param string|null $id Unique identifier for this function call.
     * @param string|null $name The name of the function to call.
     * @param mixed $args The arguments to pass to the function.
     * @throws InvalidArgumentException If neither id nor name is provided.
     */
    public function __construct(?string $id = null, ?string $name = null, $args = null)
    {
        if ($id === null &amp;&amp; $name === null) {
            throw new InvalidArgumentException(&#039;At least one of id or name must be provided.&#039;);
        }
        $this-&gt;id = $id;
        $this-&gt;name = $name;
        $this-&gt;args = $args;
    }
    /**
     * Gets the function call ID.
     *
     * @since 0.1.0
     *
     * @return string|null The function call ID.
     */
    public function getId(): ?string
    {
        return $this-&gt;id;
    }
    /**
     * Gets the function name.
     *
     * @since 0.1.0
     *
     * @return string|null The function name.
     */
    public function getName(): ?string
    {
        return $this-&gt;name;
    }
    /**
     * Gets the function arguments.
     *
     * @since 0.1.0
     *
     * @return mixed The function arguments.
     */
    public function getArgs()
    {
        return $this-&gt;args;
    }
    /**
     * {@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;Unique identifier for this function call.&#039;], self::KEY_NAME =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;The name of the function to call.&#039;], self::KEY_ARGS =&gt; [&#039;type&#039; =&gt; [&#039;string&#039;, &#039;number&#039;, &#039;boolean&#039;, &#039;object&#039;, &#039;array&#039;, &#039;null&#039;], &#039;description&#039; =&gt; &#039;The arguments to pass to the function.&#039;]], &#039;anyOf&#039; =&gt; [[&#039;required&#039; =&gt; [self::KEY_ID]], [&#039;required&#039; =&gt; [self::KEY_NAME]]]];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return FunctionCallArrayShape
     */
    public function toArray(): array
    {
        $data = [];
        if ($this-&gt;id !== null) {
            $data[self::KEY_ID] = $this-&gt;id;
        }
        if ($this-&gt;name !== null) {
            $data[self::KEY_NAME] = $this-&gt;name;
        }
        if ($this-&gt;args !== null) {
            $data[self::KEY_ARGS] = $this-&gt;args;
        }
        return $data;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function fromArray(array $array): self
    {
        return new self($array[self::KEY_ID] ?? null, $array[self::KEY_NAME] ?? null, $array[self::KEY_ARGS] ?? null);
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fyogitonics.com%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FTools%2FDTO'>⬅ Back to Directory</a>