world.ptah.action

ptah.world

Documentation

The heartbeat of a world. Something happened. Attributed to a character, timestamped, permanent.

main record

The heartbeat of a world. Something happened. Attributed to a character, timestamped, permanent.

Record Key tid Timestamp-based ID

Properties

actionType string Optional

The type of action

Known values: narrative, dialogue, witness, competitive, administrative
actorDID string did Required

The permanent identity of the person who took this action

characterReference string at-uri Optional

Reference to the character who took this action

content string Optional

The content of the action — what happened

maxLength: 30720 bytesmaxGraphemes: 3000 graphemes
createdAt string datetime Required

Timestamp when this action was taken

eventReference string at-uri Optional

Reference to the event this action is part of

locationReference string at-uri Optional

Reference to the location where this action occurred

narrativeWeight integer Optional

Optional importance scoring hook (null default, non-breaking)

parentAction string at-uri Optional

Reference to the action this is responding to (for threading)

visibility string Optional

The visibility tier of this action

Known values: canon, community, experimental
worldReference string at-uri Required

Reference to the world this action occurred in

View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "actorDID",
      "worldReference",
      "createdAt"
    ],
    "properties": {
      "content": {
        "type": "string",
        "maxLength": 30720,
        "description": "The content of the action — what happened",
        "maxGraphemes": 3000
      },
      "actorDID": {
        "type": "string",
        "format": "did",
        "description": "The permanent identity of the person who took this action"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp when this action was taken"
      },
      "actionType": {
        "type": "string",
        "description": "The type of action",
        "knownValues": [
          "narrative",
          "dialogue",
          "witness",
          "competitive",
          "administrative"
        ]
      },
      "visibility": {
        "type": "string",
        "description": "The visibility tier of this action",
        "knownValues": [
          "canon",
          "community",
          "experimental"
        ]
      },
      "parentAction": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the action this is responding to (for threading)"
      },
      "eventReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the event this action is part of"
      },
      "worldReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the world this action occurred in"
      },
      "narrativeWeight": {
        "type": "integer",
        "description": "Optional importance scoring hook (null default, non-breaking)"
      },
      "locationReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the location where this action occurred"
      },
      "characterReference": {
        "type": "string",
        "format": "at-uri",
        "description": "Reference to the character who took this action"
      }
    }
  },
  "description": "The heartbeat of a world. Something happened. Attributed to a character, timestamped, permanent."
}

Lexicon Garden

@