Class AgentActivityLog

backend/app/models/activity_log.py:13–33

Records every action taken by a digital employee.

class AgentActivityLog(Base):
    """Records every action taken by a digital employee."""

    __tablename__ = "agent_activity_logs"

    id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4)
    agent_id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), ForeignKey("agents.id"), nullable=False, index=True)
    action_type: Mapped[str] = mapped_column(
        Enum(
            "chat_reply", "tool_call", "feishu_msg_sent", "agent_msg_sent",
            "web_msg_sent", "task_created", "task_updated", "file_written", "error",
            "schedule_run", "heartbeat", "plaza_post",
            name="activity_action_enum",
            create_constraint=False,
        ),
        nullable=False,
    )
    summary: Mapped[str] = mapped_column(String(500), nullable=False)
    detail_json: Mapped[dict | None] = mapped_column(JSON, default=None)
    related_id: Mapped[uuid.UUID | None] = mapped_column(UUID(as_uuid=True))
    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now(), index=True)

class DailyTokenUsage(Base):
    """Rolled up token consumption per agent per day for time-series analytics."""