# garden.engram.agents.handoff

> Published by [hailey.at](https://lexicon.garden/identity/did:plc:oisofpd7lj26yvgiivf3lxsi)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:oisofpd7lj26yvgiivf3lxsi/garden.engram.agents.handoff)
- [Documentation](https://lexicon.garden/lexicon/did:plc:oisofpd7lj26yvgiivf3lxsi/garden.engram.agents.handoff/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:oisofpd7lj26yvgiivf3lxsi/garden.engram.agents.handoff/examples)

## Definitions

### `garden.engram.agents.handoff`

**Type**: `record`

Written by a run that has stopped because another run took over the agent. Its record key is the new run's TID, so each handoff is acknowledged at most once. Never edited.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes |  |
| `fromRun` | `string` (tid) | Yes |  |
| `generator` | `ref` → `garden.engram.agents.defs#generator` | No |  |
| `toRun` | `string` (tid) | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Written by a run that has stopped because another run took over the agent. Its record key is the new run's TID, so each handoff is acknowledged at most once. Never edited.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "fromRun": {
            "format": "tid",
            "type": "string"
          },
          "generator": {
            "ref": "garden.engram.agents.defs#generator",
            "type": "ref"
          },
          "toRun": {
            "format": "tid",
            "type": "string"
          }
        },
        "required": [
          "fromRun",
          "toRun",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "garden.engram.agents.handoff",
  "lexicon": 1
}
```