> ## 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.

# Run lineage

> How Veryfront connects conversations, messages, runs, and child work.

Run lineage connects visible conversation state to the work behind it.

```mermaid theme={null}
flowchart TB
  Conversation[Conversation] --> Message[Message]
  Message --> AgentRun[Agent run]
  AgentRun --> Run[Run]
  WorkflowRun[Workflow run] --> Run
  JobRun[Job run] --> Run
  Run --> Parent[Parent run]
  Run --> Root[Root run]
  AgentRun --> Event[Run events]
  AgentRun --> Tool[Tool call]
```

## Lineage fields

| Field                   | Meaning                                                            |
| ----------------------- | ------------------------------------------------------------------ |
| `conversationId`        | Conversation that owns messages and conversation-owned runs.       |
| `messageId`             | Message associated with input or output.                           |
| `runId`                 | Durable run ID.                                                    |
| `kind`                  | Run kind, such as `agent`, `workflow`, or `job`.                   |
| `owner`                 | Scope that owns the run.                                           |
| `rootRunId`             | First run in a run tree.                                           |
| `parentRunId`           | Run that spawned a child run.                                      |
| `spawnedFromToolCallId` | Tool call that started a child run.                                |
| `latestEventId`         | Latest persisted event for the run.                                |
| `cronJobId`             | Schedule that created a job run.                                   |
| `jobId`                 | Job record for background execution.                               |
| `target`                | Runtime target, such as a task, workflow, deploy, or agent target. |

## Reading lineage

Start with the conversation or run ID.

Parent and root IDs show related work. Run events show execution history.