"""聊天历史纯组装函数（IO 查询已迁 services/chat）。

``history_pairs`` 把已加载的消息列表转成 ``(role, content)`` 对，供上下文组装使用。
本模块只接收已加载数据。
"""

from __future__ import annotations

from app.models.chat import ChatMessage


def history_pairs(messages: list[ChatMessage]) -> list[tuple[str, str]]:
    """把消息列表转成 (role, content) 对，供上下文组装使用。"""
    return [
        (message.role, message.content)
        for message in messages
        if message.role in {"user", "assistant", "system"}
    ]