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

# Connect an agent

> How developer-provided agents connect to Conversations API runs.

Project agents connect Conversations API runs to your runtime.

The runtime publishes available agents and streams AG-UI events.

It also resumes and cancels long-running work.

```mermaid theme={null}
flowchart LR
  API[Veryfront API] -->|Start run| Runtime[Project runtime]
  API -->|Resume run| Runtime
  API -->|Cancel run| Runtime
  Runtime -->|AG-UI events| API
  API -->|Persist events| Store[(Run events)]
```

## Minimum contract

| Capability  | Runtime responsibility                                               |
| ----------- | -------------------------------------------------------------------- |
| Discover    | Return available agents and metadata.                                |
| Stream      | Return AG-UI events for active work.                                 |
| Resume      | Accept a tool result or resume signal for a waiting run.             |
| Cancel      | Stop active execution for a run ID.                                  |
| Identify    | Preserve run ID, conversation ID, parent run, and tool-call lineage. |
| Emit events | Send event payloads that Veryfront can persist and replay.           |