> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Runs and events

> How Veryfront tracks agent, job, and workflow execution.

A run is a tracked unit of work.

An event is an ordered record of what happened during that run.

Veryfront uses runs and events for agents, jobs, workflows, webhooks, and long-running work.

## Why runs matter

Runs give work an identity, status, owner, and result.

With runs, Cloud can show progress, replay output, cancel work, and explain failures.

## Event types

| Event kind | Purpose                                            |
| ---------- | -------------------------------------------------- |
| Lifecycle  | Run started, completed, failed, or was cancelled.  |
| Output     | Text, files, tool results, and other emitted data. |
| Tool       | Tool call start, arguments, result, and error.     |
| State      | Runtime status updates.                            |
| Diagnostic | Errors, logs, and trace links.                     |

Use logs for runtime output. Use traces and run events when you need execution history.