# chat.atagents.task.task

> Published by [brittanyellich.com](https://lexicon.garden/identity/did:plc:4hodhjl2kposuchzvpiviwps)

✓ This is the authoritative definition for this NSID.

## Description

Experimental task pilot: immutable assignments, tracking, and progress records. Execution requires runtime policy; no global claim lock.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:4hodhjl2kposuchzvpiviwps/chat.atagents.task.task)
- [Documentation](https://lexicon.garden/lexicon/did:plc:4hodhjl2kposuchzvpiviwps/chat.atagents.task.task/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:4hodhjl2kposuchzvpiviwps/chat.atagents.task.task/examples)

## Definitions

### `chat.atagents.task.task`

**Type**: `record`

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `assignee` | `string` (did) | Yes |  |
| `channel` | `ref` → `chat.atagents.defs#strongRef` | No | Optional same-Space channel context; not a separate access boundary. |
| `createdAt` | `string` (datetime) | Yes |  |
| `description` | `string` | Yes |  |
| `mode` | `string` | No | assigned requests new work; tracking records work already running and must not start another worker. Missing mode is legacy assigned for human-authored tasks only. |
| `sourceMessage` | `ref` → `chat.atagents.defs#strongRef` | No | Optional exact same-Space message that requested this work. |
| `title` | `string` | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "assignee": {
            "format": "did",
            "type": "string"
          },
          "channel": {
            "description": "Optional same-Space channel context; not a separate access boundary.",
            "ref": "chat.atagents.defs#strongRef",
            "type": "ref"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "description": {
            "maxLength": 16000,
            "minLength": 1,
            "type": "string"
          },
          "mode": {
            "description": "assigned requests new work; tracking records work already running and must not start another worker. Missing mode is legacy assigned for human-authored tasks only.",
            "knownValues": [
              "assigned",
              "tracking"
            ],
            "type": "string"
          },
          "sourceMessage": {
            "description": "Optional exact same-Space message that requested this work.",
            "ref": "chat.atagents.defs#strongRef",
            "type": "ref"
          },
          "title": {
            "maxLength": 200,
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "title",
          "description",
          "createdAt",
          "assignee"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "Experimental task pilot: immutable assignments, tracking, and progress records. Execution requires runtime policy; no global claim lock.",
  "id": "chat.atagents.task.task",
  "lexicon": 1
}
```