Commit inicial, se subio el proyecto
This commit is contained in:
@@ -0,0 +1,97 @@
|
||||
<?php
|
||||
|
||||
declare (strict_types=1);
|
||||
namespace WordPress\AiClient\Events;
|
||||
|
||||
use WordPress\AiClient\Messages\DTO\Message;
|
||||
use WordPress\AiClient\Providers\Models\Contracts\ModelInterface;
|
||||
use WordPress\AiClient\Providers\Models\Enums\CapabilityEnum;
|
||||
/**
|
||||
* Event dispatched before a prompt is sent to the AI model.
|
||||
*
|
||||
* This event allows listeners to inspect and modify the messages before they
|
||||
* are sent to the model. The event is not stoppable, meaning the model call
|
||||
* will always proceed regardless of listener actions.
|
||||
*
|
||||
* @since 0.4.0
|
||||
*/
|
||||
class BeforeGenerateResultEvent
|
||||
{
|
||||
/**
|
||||
* @var list<Message> The messages to be sent to the model.
|
||||
*/
|
||||
private array $messages;
|
||||
/**
|
||||
* @var ModelInterface The model that will process the prompt.
|
||||
*/
|
||||
private ModelInterface $model;
|
||||
/**
|
||||
* @var CapabilityEnum|null The capability being used for generation.
|
||||
*/
|
||||
private ?CapabilityEnum $capability;
|
||||
/**
|
||||
* Constructor.
|
||||
*
|
||||
* @since 0.4.0
|
||||
*
|
||||
* @param list<Message> $messages The messages to be sent to the model.
|
||||
* @param ModelInterface $model The model that will process the prompt.
|
||||
* @param CapabilityEnum|null $capability The capability being used for generation.
|
||||
*/
|
||||
public function __construct(array $messages, ModelInterface $model, ?CapabilityEnum $capability)
|
||||
{
|
||||
$this->messages = $messages;
|
||||
$this->model = $model;
|
||||
$this->capability = $capability;
|
||||
}
|
||||
/**
|
||||
* Gets the messages to be sent to the model.
|
||||
*
|
||||
* @since 0.4.0
|
||||
*
|
||||
* @return list<Message> The messages.
|
||||
*/
|
||||
public function getMessages(): array
|
||||
{
|
||||
return $this->messages;
|
||||
}
|
||||
/**
|
||||
* Gets the model that will process the prompt.
|
||||
*
|
||||
* @since 0.4.0
|
||||
*
|
||||
* @return ModelInterface The model.
|
||||
*/
|
||||
public function getModel(): ModelInterface
|
||||
{
|
||||
return $this->model;
|
||||
}
|
||||
/**
|
||||
* Gets the capability being used for generation.
|
||||
*
|
||||
* @since 0.4.0
|
||||
*
|
||||
* @return CapabilityEnum|null The capability, or null if not specified.
|
||||
*/
|
||||
public function getCapability(): ?CapabilityEnum
|
||||
{
|
||||
return $this->capability;
|
||||
}
|
||||
/**
|
||||
* Performs a deep clone of the event.
|
||||
*
|
||||
* This method ensures that message objects are cloned to prevent
|
||||
* modifications to the cloned event from affecting the original.
|
||||
* The model object is not cloned as it is a service object.
|
||||
*
|
||||
* @since 0.4.2
|
||||
*/
|
||||
public function __clone()
|
||||
{
|
||||
$clonedMessages = [];
|
||||
foreach ($this->messages as $message) {
|
||||
$clonedMessages[] = clone $message;
|
||||
}
|
||||
$this->messages = $clonedMessages;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user