AstroResearch/migrations/20260819000001_add_agent_events.sql

-- 会话事件日志：turn/compaction 生命周期 + 上下文快照（事件溯源中枢）
--
-- 设计（参考 deepseek-harness 的事件溯源会话模型）：
--   agent_messages 记录"模型可见内容"，agent_events 记录"生命周期事实"。
--   turn_start/turn_end 构成日志化锁：崩溃后开着的 turn_start 可被检测并
--   合成 interrupted 关闭（不截断已持久化的部分）。
--   context_snapshot 存储压缩后的折叠上下文，下一 turn 直接回放而无需
--   从原始消息重建再重新压缩（节省重复的 LLM 摘要调用）。
--
-- 事件类型（event_type）：
--   turn_start / turn_end / turn_interrupted
--   compaction_start / compaction_end / compaction_interrupted
--   context_snapshot

CREATE TABLE IF NOT EXISTS agent_events (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    session_id TEXT NOT NULL,
    turn_index INTEGER NOT NULL DEFAULT 0,
    event_type TEXT NOT NULL,
    payload TEXT,
    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);

CREATE INDEX IF NOT EXISTS idx_agent_events_session
    ON agent_events(session_id, id);