"""ORM model for run events.""" from __future__ import annotations from datetime import UTC, datetime from sqlalchemy import JSON, DateTime, Index, String, Text, UniqueConstraint from sqlalchemy.orm import Mapped, mapped_column from deerflow.persistence.base import Base class RunEventRow(Base): __tablename__ = "run_events" id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True) thread_id: Mapped[str] = mapped_column(String(64), nullable=False) run_id: Mapped[str] = mapped_column(String(64), nullable=False) event_type: Mapped[str] = mapped_column(String(32), nullable=False) category: Mapped[str] = mapped_column(String(16), nullable=False) # "message" | "trace" | "lifecycle" content: Mapped[str] = mapped_column(Text, default="") event_metadata: Mapped[dict] = mapped_column(JSON, default=dict) seq: Mapped[int] = mapped_column(nullable=False) created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(UTC)) __table_args__ = ( UniqueConstraint("thread_id", "seq", name="uq_events_thread_seq"), Index("ix_events_thread_cat_seq", "thread_id", "category", "seq"), Index("ix_events_run", "thread_id", "run_id", "seq"), )