GenerativeAiOperation

24class GenerativeAiOperation extends AbstractDataTransferObject implements OperationInterface25{26    public const KEY_ID = 'id';27    public const KEY_STATE = 'state';28    public const KEY_RESULT = 'result';29    /**30     * @var string Unique identifier for this operation.31     */32    private string $id;33    /**34     * @var OperationStateEnum The current state of the operation.35     */36    private OperationStateEnum $state;37    /**38     * @var GenerativeAiResult|null The result once the operation completes.39     */40    private ?GenerativeAiResult $result;41    /**42     * Constructor.43     *44     * @since 0.1.045     *46     * @param string $id Unique identifier for this operation.47     * @param OperationStateEnum $state The current state of the operation.48     * @param GenerativeAiResult|null $result The result once the operation completes.49     */50    public function __construct(string $id, OperationStateEnum $state, ?GenerativeAiResult $result = null)51    {52        $this->id = $id;53        $this->state = $state;54        $this->result = $result;55    }56    /**57     * Creates a deep clone of this operation.58     *59     * Clones the result object if present to ensure the cloned60     * operation is independent of the original.61     * The state enum is immutable and can be safely shared.62     *63     * @since 0.4.264     */65    public function __clone()66    {67        // Clone the result if present (GenerativeAiResult has __clone)68        if ($this->result !== null) {69            $this->result = clone $this->result;70        }71        // Note: $state is an immutable enum and can be safely shared72    }73    /**74     * {@inheritDoc}75     *76     * @since 0.1.077     */78    public function getId(): string79    {80        return $this->id;81    }82    /**83     * {@inheritDoc}84     *85     * @since 0.1.086     */87    public function getState(): OperationStateEnum88    {89        return $this->state;90    }91    /**92     * Gets the operation result.93     *94     * @since 0.1.095     *96     * @return GenerativeAiResult|null The result or null if not yet complete.97     */98    public function getResult(): ?GenerativeAiResult99    {100        return $this->result;101    }102    /**103     * {@inheritDoc}