# garden.engram.agents.observation

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

## Definitions

### `garden.engram.agents.observation`

**Type**: `record`

An outside fact entering the workspace: a fetched page, a file, a command's output, or something the operator said. Claims cite observations rather than each other. Never edited: a changed source gets a new observation that supersedes this one.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `content` | `blob` | No | The exact bytes observed. |
| `createdAt` | `string` (datetime) | Yes |  |
| `generator` | `ref` → `garden.engram.agents.defs#generator` | Yes |  |
| `method` | `string` | Yes | How it was observed, e.g. the tool name. |
| `observedAt` | `string` (datetime) | Yes |  |
| `source` | `ref` → `garden.engram.agents.defs#source` | Yes |  |
| `supersedes` | `ref` → `com.atproto.repo.strongRef` | No |  |
| `text` | `string` | Yes | The content as text (or its start, when content holds more), for quoting and search. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "An outside fact entering the workspace: a fetched page, a file, a command's output, or something the operator said. Claims cite observations rather than each other. Never edited: a changed source gets a new observation that supersedes this one.",
      "key": "tid",
      "record": {
        "properties": {
          "content": {
            "description": "The exact bytes observed.",
            "type": "blob"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "generator": {
            "ref": "garden.engram.agents.defs#generator",
            "type": "ref"
          },
          "method": {
            "description": "How it was observed, e.g. the tool name.",
            "maxLength": 256,
            "type": "string"
          },
          "observedAt": {
            "format": "datetime",
            "type": "string"
          },
          "source": {
            "ref": "garden.engram.agents.defs#source",
            "type": "ref"
          },
          "supersedes": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "text": {
            "description": "The content as text (or its start, when content holds more), for quoting and search.",
            "maxGraphemes": 10000,
            "maxLength": 100000,
            "type": "string"
          }
        },
        "required": [
          "source",
          "method",
          "observedAt",
          "text",
          "generator",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "garden.engram.agents.observation",
  "lexicon": 1
}
```