ChronicleSchema

Person

A human individual represented by a source, such as a message participant or computer user.

Properties

PropertyExpected typeDescription
From Agent
memberOf manyEntityAn entity the agent belongs to, such as a realm representing the computer system in which a user account exists.
From Entity
about manyEntityAn entity representing the subject matter of this entity, such as a topic or tag describing what a task concerns.
body oneTextThe textual content of an entity, such as a shell command or message, as supplied by the source.
description oneTextDescriptive text supplied by the source about an entity, such as a task's notes or a project's summary.
handle oneTextA contextual identifier for an entity within its namespace, such as a username, channel slug, or tag label. Its meaning depends on the source or context in which it is used.
inRealm oneRealmThe realm in which an entity resides, such as the computer system hosting a conversation or file. Provides context for identifiers that are local to that realm.
isPartOf manyEntityAn entity that this entity forms part of, such as a task's project or collection, or the page containing an excerpt. Each value identifies a containing whole.
name oneTextThe human-readable name or title of an entity, such as a person's display name, a document title, or a place name.
sameAs manyEntity or TextAnother reference to the same entity, expressed as an entity node or a textual identity reference such as @me. Asserts shared identity, rather than similarity or association.
url oneURLA URL at which the entity can be found, such as a web page's address or a link to a source record.
From Base
source oneTextThe source system that describes the entity or action, such as things-todo. Provides the source namespace in which identifiers such as sourceId are interpreted.
sourceId oneTextThe identifier assigned by the source to an entity or action, such as a record ID or message ID. Represented as text and scoped to the source's own namespace; it need not be globally unique.

Used as a value

A Person can be the value of these properties.

Examples

Running a shell command

An ExecuteAction for one command from shell history.

{
  "@type": "ExecuteAction",
  "@key": [
    "@type",
    "source",
    "timestamp",
    "object.body",
    "agent.handle",
    "agent.memberOf[*].handle"
  ],
  "source": "shell",
  "timestamp": "2026-03-14T09:26:53.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle", "memberOf[*].handle"],
    "source": "shell",
    "handle": "sam",
    "memberOf": [
      {
        "@type": "Realm",
        "@key": ["@type", "source", "handle"],
        "source": "hostname",
        "handle": "studio"
      }
    ],
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Command",
    "@key": ["@type", "source", "body", "action.timestamp"],
    "source": "shell",
    "body": "git log --oneline -5"
  }
}

Your prompt in a coding session

A message you sent in an AI coding session.

{
  "@type": "MessageAction",
  "@key": ["@type", "source", "sourceId"],
  "source": "claude-code",
  "sourceId": "a3c81f6e-2b94-4e7d-9c05-7f1b8d2e6a53",
  "timestamp": "2026-07-02T10:40:58.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "sourceId"],
    "source": "claude",
    "sourceId": "4e9b2d17-8c3a-4f65-a1e0-6b7d9c2f5a38",
    "handle": "sam@example.com",
    "name": "Sam Rivera",
    "sameAs": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "email",
        "handle": "sam@example.com",
        "name": "Sam Rivera"
      },
      "@me"
    ]
  },
  "object": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "claude-code",
    "sourceId": "a3c81f6e-2b94-4e7d-9c05-7f1b8d2e6a53",
    "body": "Why does the date test fail on CI but pass locally?",
    "author": [
      {
        "@type": "Person",
        "@key": ["@type", "source", "sourceId"],
        "source": "claude",
        "sourceId": "4e9b2d17-8c3a-4f65-a1e0-6b7d9c2f5a38",
        "sameAs": ["@me"]
      }
    ],
    "isPartOf": [
      {
        "@type": "Thread",
        "@key": ["@type", "source", "sourceId"],
        "source": "claude-code",
        "sourceId": "6d2a9e71-3c5b-4f08-b4e2-9a7c1d5f8e26",
        "name": "Fix the flaky date test"
      }
    ]
  }
}

URI https://schema.chronicle.app/Person

Esc

↑↓ to move↵ to open/ or ⌘K to search