PromptBuilder

50class PromptBuilder51{52    /**53     * @var ProviderRegistry The provider registry for finding suitable models.54     */55    private ProviderRegistry $registry;56    /**57     * @var list<Message> The messages in the conversation.58     */59    protected array $messages = [];60    /**61     * @var ModelInterface|null The model to use for generation.62     */63    protected ?ModelInterface $model = null;64    /**65     * @var list<string> Ordered list of preference keys to check when selecting a model.66     */67    protected array $modelPreferenceKeys = [];68    /**69     * @var string|null The provider ID or class name.70     */71    protected ?string $providerIdOrClassName = null;72    /**73     * @var ModelConfig The model configuration.74     */75    protected ModelConfig $modelConfig;76    /**77     * @var RequestOptions|null The request options for HTTP transport.78     */79    protected ?RequestOptions $requestOptions = null;80    /**81     * @var EventDispatcherInterface|null The event dispatcher for prompt lifecycle events.82     */83    private ?EventDispatcherInterface $eventDispatcher = null;84    // phpcs:disable Generic.Files.LineLength.TooLong85    /**86     * Constructor.87     *88     * @since 0.1.089     *90     * @param ProviderRegistry $registry The provider registry for finding suitable models.91     * @param Prompt $prompt Optional initial prompt content.92     * @param EventDispatcherInterface|null $eventDispatcher Optional event dispatcher for lifecycle events.93     */94    // phpcs:enable Generic.Files.LineLength.TooLong95    public function __construct(ProviderRegistry $registry, $prompt = null, ?EventDispatcherInterface $eventDispatcher = null)96    {97        $this->registry = $registry;98        $this->modelConfig = new ModelConfig();99        $this->eventDispatcher = $eventDispatcher;100        if ($prompt === null) {101            return;102        }103        // Check if it's a list of Messages - set as messages104        if ($this->isMessagesList($prompt)) {105            $this->messages = $prompt;106            return;107        }108        // Parse it as a user message109        $userMessage = $this->parseMessage($prompt, MessageRoleEnum::user());110        $this->messages[] = $userMessage;111    }112    /**113     * Creates a deep clone of this builder.114     *115     * Clones all mutable state including messages, model configuration, and request options.116     * Service objects (registry, model, event dispatcher) are intentionally NOT cloned117     * as they are shared dependencies.118     *119     * @since 0.4.2120     */121    public function __clone()122    {123        // Deep clone messages array (Message has __clone)124        $clonedMessages = [];125        foreach ($this->messages as $message) {126            $clonedMessages[] = clone $message;127        }128        $this->messages = $clonedMessages;129        // Clone model config (ModelConfig has __clone)