---
title: "Turn"
description: "one unit of the agent's work, started by one input and ended when its outputs are produced; it holds items in order"
section: concepts
address: /concepts/turn
contract: 0476e35e6e275db5
---

# Turn

one unit of the agent's work, started by one input and ended when its outputs are produced; it holds items in order

[figure: Turn is a work at strategy scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | work |
| scope | strategy |
| key | the thread and its sequence |
| store | postgres |
| family | harness |



## Fields


| field | type | required | note |
|---|---|---|---|
| `thread` | `id` | yes |  |
| `sequence` | `count` | yes |  |
| `input` | `text` | yes |  |
| `started_at` | `time` | yes |  |
| `ended_at` | `time` | no |  |
| `outcome` | `one of completed \| cancelled \| failed \| waiting` | no |  |
| `items` | [Item](/concepts/item) | yes |  |



## Routes that use it
No route takes or returns Turn directly. The record holds it, and the objects that point at it reach it.