ChronicleSchema
Used on
Action and their subclasses
Expected type
Agent
Values
At most one value
Required
No

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"
  }
}

Sending a voice message

A message you sent, so you are the agent and the other person is the recipient.

{
  "@type": "MessageAction",
  "@key": ["source", "sourceId", "@type"],
  "source": "imessage",
  "sourceId": "3F8D2B6C-5A19-4E7B-9C4D-1E6A8F2B0C97",
  "timestamp": "2026-05-09T18:25:41.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle"],
    "source": "phone",
    "handle": "+15555550123",
    "sameAs": ["@me"]
  },
  "object": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "imessage",
    "sourceId": "3F8D2B6C-5A19-4E7B-9C4D-1E6A8F2B0C97",
    "body": "",
    "recipient": [
      {
        "@type": "Agent",
        "@key": ["@type", "source", "handle"],
        "source": "icloud",
        "handle": "alex@example.com",
        "name": "Alex Chen"
      }
    ],
    "contains": [
      {
        "@type": "AudioObject",
        "@key": ["source", "sourceId"],
        "source": "imessage",
        "sourceId": "B2E9F4A1-6C3D-4B8E-A7F0-5D1C3E9B2A64",
        "contentPath": "/Users/sam/Library/Messages/Attachments/a2/02/Audio Message.caf",
        "mimeType": "audio/x-caf",
        "description": "Audio Message.caf"
      }
    ]
  }
}

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

Esc

to move to open/ or ⌘K to search