openclaw-mission-control/backend/app/schemas/activity_events.py

"""Response schemas for activity events and task-comment feed items."""

from __future__ import annotations

from datetime import datetime  # noqa: TCH003
from uuid import UUID  # noqa: TCH003

from sqlmodel import SQLModel


class ActivityEventRead(SQLModel):
    """Serialized activity event payload returned by activity endpoints."""

    id: UUID
    event_type: str
    message: str | None
    agent_id: UUID | None
    task_id: UUID | None
    created_at: datetime


class ActivityTaskCommentFeedItemRead(SQLModel):
    """Denormalized task-comment feed item enriched with task and board fields."""

    id: UUID
    created_at: datetime
    message: str | None
    agent_id: UUID | None
    agent_name: str | None = None
    agent_role: str | None = None
    task_id: UUID
    task_title: str
    board_id: UUID
    board_name: str