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

In other vocabularies

VocabularyTerm
schema.org Same as agent
Activity Streams 2.0 Same as actor

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": ["@type", "source", "result.sourceId"],
  "source": "imessage",
  "timestamp": "2026-05-09T18:25:41.000Z",
  "agent": {
    "@type": "Person",
    "@key": ["@type", "source", "handle"],
    "source": "phone",
    "handle": "+15555550123",
    "sameAs": ["@me"]
  },
  "result": {
    "@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 · Suggest a change

Esc

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