# garden.engram.agents.task

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

## Definitions

### `garden.engram.agents.task`

**Type**: `record`

A unit of work. Never edited: its state is computed from the garden.engram.agents.taskEvent records that point at it.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `assignee` | `string` (did) | No | When set, only this agent's claims count. |
| `createdAt` | `string` (datetime) | Yes |  |
| `description` | `string` | No |  |
| `doneWhen` | `string` | No |  |
| `generator` | `ref` → `garden.engram.agents.defs#generator` | No |  |
| `inputs` | `array` | No |  |
| `requiresApproval` | `boolean` | No | When true, claims count only after the operator writes an approve event. |
| `title` | `string` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A unit of work. Never edited: its state is computed from the garden.engram.agents.taskEvent records that point at it.",
      "key": "tid",
      "record": {
        "properties": {
          "assignee": {
            "description": "When set, only this agent's claims count.",
            "format": "did",
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "maxGraphemes": 10000,
            "maxLength": 30000,
            "type": "string"
          },
          "doneWhen": {
            "maxGraphemes": 1000,
            "maxLength": 3000,
            "type": "string"
          },
          "generator": {
            "ref": "garden.engram.agents.defs#generator",
            "type": "ref"
          },
          "inputs": {
            "items": {
              "ref": "com.atproto.repo.strongRef",
              "type": "ref"
            },
            "maxLength": 64,
            "type": "array"
          },
          "requiresApproval": {
            "description": "When true, claims count only after the operator writes an approve event.",
            "type": "boolean"
          },
          "title": {
            "maxGraphemes": 300,
            "maxLength": 1000,
            "type": "string"
          }
        },
        "required": [
          "title",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "garden.engram.agents.task",
  "lexicon": 1
}
```