<?php
/**
 * Session model.
 *
 * @package MazeAi
 * @since   0.1.0
 */

declare(strict_types=1);

namespace MazeAi\Models;

defined('ABSPATH') || exit;

use Illuminate\MazeAssistant\Database\Eloquent\Model;

/**
 * One chat session of one user: its index card and the state of its run. The conversation is in `maze_graph_entries`.
 *
 * @since 0.1.0
 *
 * @property int         $id
 * @property string      $uuid             The id the browser and the REST API use.
 * @property int         $user_id
 * @property string      $title
 * @property string      $title_source     `auto` (first words of the first message) or `user`.
 * @property string      $model            `provider:model`, or '' for the site default.
 * @property string      $agent            Agent selected for the session.
 * @property string      $permission_mode  `ask`, `auto` or `full`; defaults to `ask`.
 * @property string|null $pinned_at        Set while the owner has pinned this session.
 * @property string|null $archived_at      Set while the owner has archived this session.
 * @property string|null $run_id
 * @property string      $run_status       `idle`, `running`, `done`, `cancelled` or `error`.
 * @property int         $run_step
 * @property string|null $run_reason
 * @property string|null $run_lease_until
 * @property int         $entry_count
 * @property int         $tokens_in
 * @property int         $tokens_out
 * @property string|null $last_activity_at
 * @property string|null $deleted_at       Set while the session waits in the undo window, then it is purged.
 * @property string|null $created_at
 * @property string|null $updated_at
 */
class Session extends Model
{
    protected string $table = 'maze_graph_sessions';

    protected array $fillable = ['uuid', 'user_id', 'title', 'title_source', 'model', 'agent', 'permission_mode', 'pinned_at', 'archived_at', 'last_activity_at'];

    protected array $casts = [
        'id'          => 'int',
        'user_id'     => 'int',
        'run_step'    => 'int',
        'entry_count' => 'int',
        'tokens_in'   => 'int',
        'tokens_out'  => 'int',
    ];
}