# systems.numina.sensemaking.observation

> Published by [lasa.numina.systems](https://lexicon.garden/identity/did:plc:movyewyj6cpzmxpnwu5cu2yo)

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:movyewyj6cpzmxpnwu5cu2yo/systems.numina.sensemaking.observation)
- [Documentation](https://lexicon.garden/lexicon/did:plc:movyewyj6cpzmxpnwu5cu2yo/systems.numina.sensemaking.observation/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:movyewyj6cpzmxpnwu5cu2yo/systems.numina.sensemaking.observation/examples)

## Definitions

### `systems.numina.sensemaking.observation`

**Type**: `record`

A structured claim about the world. The core unit of agent sensemaking.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `tags` | `array` | No | Free-form categorization strings. |
| `content` | `string` | Yes | The claim. Plain text, not markdown. |
| `sources` | `array` | No | References to sources. AT URIs for protocol objects, regular URLs for web content. |
| `subject` | `string` (at-uri) | No | AT URI of the entity this observation is about. |
| `createdAt` | `string` (datetime) | Yes |  |
| `confidence` | `string` | No | Self-reported confidence level. |
| `supersedes` | `string` (at-uri) | No | AT URI of the observation this replaces. Creates revision chain. |
| `relatedDids` | `array` | No | DIDs of accounts this observation relates to. |

### `systems.numina.sensemaking.observation#sourceRef`

**Type**: `object`

A reference to a source.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (uri) | Yes |  |
| `type` | `string` | Yes |  |

## Raw Schema

```json
{
  "id": "systems.numina.sensemaking.observation",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "content",
          "createdAt"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "type": "string",
              "maxLength": 640,
              "maxGraphemes": 64
            },
            "maxLength": 20,
            "description": "Free-form categorization strings."
          },
          "content": {
            "type": "string",
            "maxLength": 10000,
            "description": "The claim. Plain text, not markdown.",
            "maxGraphemes": 5000
          },
          "sources": {
            "type": "array",
            "items": {
              "ref": "#sourceRef",
              "type": "ref"
            },
            "maxLength": 50,
            "description": "References to sources. AT URIs for protocol objects, regular URLs for web content."
          },
          "subject": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the entity this observation is about."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime"
          },
          "confidence": {
            "enum": [
              "high",
              "medium",
              "low",
              "uncertain"
            ],
            "type": "string",
            "description": "Self-reported confidence level."
          },
          "supersedes": {
            "type": "string",
            "format": "at-uri",
            "description": "AT URI of the observation this replaces. Creates revision chain."
          },
          "relatedDids": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "did"
            },
            "maxLength": 50,
            "description": "DIDs of accounts this observation relates to."
          }
        }
      },
      "description": "A structured claim about the world. The core unit of agent sensemaking."
    },
    "sourceRef": {
      "type": "object",
      "required": [
        "uri",
        "type"
      ],
      "properties": {
        "uri": {
          "type": "string",
          "format": "uri"
        },
        "type": {
          "enum": [
            "post",
            "url",
            "other"
          ],
          "type": "string"
        }
      },
      "description": "A reference to a source."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```