php-agentic/Models/PromptVersion.php

<?php

declare(strict_types=1);

namespace Core\Mod\Agentic\Models;

use Core\Tenant\Models\User;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * Prompt version snapshot for history and rollback.
 *
 * Captures the state of a prompt at a point in time, enabling
 * version history and rollback via the restore() method.
 *
 * @property int $id
 * @property int $prompt_id
 * @property int $version
 * @property string|null $system_prompt
 * @property string|null $user_template
 * @property array|null $variables
 * @property int|null $created_by
 * @property \Carbon\Carbon|null $created_at
 * @property \Carbon\Carbon|null $updated_at
 */
class PromptVersion extends Model
{
    protected $fillable = [
        'prompt_id',
        'version',
        'system_prompt',
        'user_template',
        'variables',
        'created_by',
    ];

    protected $casts = [
        'variables' => 'array',
        'version' => 'integer',
    ];

    /**
     * Get the parent prompt.
     */
    public function prompt(): BelongsTo
    {
        return $this->belongsTo(Prompt::class);
    }

    /**
     * Get the user who created this version.
     */
    public function creator(): BelongsTo
    {
        return $this->belongsTo(User::class, 'created_by');
    }

    /**
     * Restore this version to the parent prompt.
     */
    public function restore(): Prompt
    {
        $this->prompt->update([
            'system_prompt' => $this->system_prompt,
            'user_template' => $this->user_template,
            'variables' => $this->variables,
        ]);

        return $this->prompt;
    }
}