Skip to main content
Version: latest

agrag.common.data_models.task.Event

Bases: BaseModel

One raw event appended to a task.

Attributes:

  • id (UUID) – Identifier derived from the task id and the sequence number.
  • task_id (UUID) – The task the event belongs to.
  • seq (int) – Gapless position of the event in its task, starting at 1.
  • kind (EventKind) – Kind of event.
  • role (str | None) – Speaker role for a message, or None.
  • name (str | None) – Tool or source name for a tool event, or None.
  • payload (str) – Stored event text. Cut to the payload limit when truncated is true.
  • payload_sha256 (str) – SHA-256 of the full text, before any cut.
  • truncated (bool) – Whether the stored payload is shorter than the full text.
  • author (str) – The agent that recorded the event.
  • at (datetime) – When the event was recorded.

at​

at: datetime

author​

author: str

id​

id: UUID

kind​

kind: EventKind

model_config​

model_config = ConfigDict(frozen=True)

name​

name: str | None

payload​

payload: str

payload_sha256​

payload_sha256: str

role​

role: str | None

seq​

seq: int

task_id​

task_id: UUID

truncated​

truncated: bool