# garden.engram.agents.taskEvent

> 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.taskEvent)
- [Documentation](https://lexicon.garden/lexicon/did:plc:oisofpd7lj26yvgiivf3lxsi/garden.engram.agents.taskEvent/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:oisofpd7lj26yvgiivf3lxsi/garden.engram.agents.taskEvent/examples)

## Definitions

### `garden.engram.agents.taskEvent`

**Type**: `record`

Something that happened to a task. Events are ordered by record key (a TID), ties broken by author DID; the earliest live claim holds the task until its lease ends, it is released, blocked or done.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `createdAt` | `string` (datetime) | Yes |  |
| `event` | `string` | Yes |  |
| `generator` | `ref` → `garden.engram.agents.defs#generator` | No |  |
| `leaseUntil` | `string` (datetime) | No | claim and progress: how long the claimant holds the task. |
| `note` | `string` | No |  |
| `output` | `ref` → `com.atproto.repo.strongRef` | No | done: the work that completes the task. |
| `task` | `ref` → `com.atproto.repo.strongRef` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Something that happened to a task. Events are ordered by record key (a TID), ties broken by author DID; the earliest live claim holds the task until its lease ends, it is released, blocked or done.",
      "key": "tid",
      "record": {
        "properties": {
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "event": {
            "knownValues": [
              "claim",
              "progress",
              "done",
              "release",
              "block",
              "approve"
            ],
            "type": "string"
          },
          "generator": {
            "ref": "garden.engram.agents.defs#generator",
            "type": "ref"
          },
          "leaseUntil": {
            "description": "claim and progress: how long the claimant holds the task.",
            "format": "datetime",
            "type": "string"
          },
          "note": {
            "maxGraphemes": 1000,
            "maxLength": 3000,
            "type": "string"
          },
          "output": {
            "description": "done: the work that completes the task.",
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "task": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          }
        },
        "required": [
          "task",
          "event",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "garden.engram.agents.taskEvent",
  "lexicon": 1
}
```