"""Defines the participant roles in a chat completion sequence."""

from enum import Enum


class Role(str, Enum):
    """Enumeration of standard personas involved in a conversation flow."""

    # High-level instructions to guide the model's behavior
    SYSTEM = "system"

    # Input or queries provided by the human user
    USER = "user"

    # Responses or messages generated by the AI model
    ASSISTANT = "assistant"

    # Output or results returned from external tool executions
    TOOL = "tool"