MessageBuilder

25class MessageBuilder26{27    /**28     * @var MessageRoleEnum|null The role of the message sender.29     */30    protected ?MessageRoleEnum $role = null;31    /**32     * @var list<MessagePart> The parts that make up the message.33     */34    protected array $parts = [];35    /**36     * Constructor.37     *38     * @since 0.2.039     *40     * @param Input $input Optional initial content.41     * @param MessageRoleEnum|null $role Optional role.42     */43    public function __construct($input = null, ?MessageRoleEnum $role = null)44    {45        $this->role = $role;46        if ($input === null) {47            return;48        }49        // Handle different input types50        if ($input instanceof MessagePart) {51            $this->parts[] = $input;52        } elseif (is_string($input)) {53            $this->withText($input);54        } elseif ($input instanceof File) {55            $this->withFile($input);56        } elseif ($input instanceof FunctionCall) {57            $this->withFunctionCall($input);58        } elseif ($input instanceof FunctionResponse) {59            $this->withFunctionResponse($input);60        } elseif (is_array($input) && MessagePart::isArrayShape($input)) {61            $this->parts[] = MessagePart::fromArray($input);62        } else {63            throw new InvalidArgumentException('Input must be a string, MessagePart, MessagePartArrayShape, File, FunctionCall, or FunctionResponse.');64        }65    }66    /**67     * Creates a deep clone of this builder.68     *69     * Clones all MessagePart objects in the parts array to ensure70     * the cloned builder is independent of the original.71     *72     * @since 0.4.273     */74    public function __clone()75    {76        // Deep clone parts array (MessagePart has __clone)77        $clonedParts = [];78        foreach ($this->parts as $part) {79            $clonedParts[] = clone $part;80        }81        $this->parts = $clonedParts;82        // Note: $role is an enum value object and can be safely shared83    }84    /**85     * Sets the role of the message sender.86     *87     * @since 0.2.088     *89     * @param MessageRoleEnum $role The role to set.90     * @return self91     */92    public function usingRole(MessageRoleEnum $role): self93    {94        $this->role = $role;95        return $this;96    }97    /**98     * Sets the role to user.99     *100     * @since 0.2.0101     *102     * @return self103     */104    public function usingUserRole(): self