ChronicleSchema

In other vocabularies

VocabularyTerm
Activity Streams 2.0 Close to Application

Properties

PropertyExpected typeDescription
From Agent
likes many Entity An entity the agent likes. A LikeAction adds an entity to the agent's likes, and an UnlikeAction removes it. A source can also give the agent's likes directly.
memberOf many Entity An entity the agent belongs to, such as the realm of the computer system that holds a user account.
From Entity
about many Entity What the entity is about, such as a topic or a tag.
alternateName many Text Another name the entity was shown with, such as the display name a message gave its sender or a recipient. An entity can have many.
body one Text The text content of an entity, such as a shell command or a message. It is plain text or Markdown. Not allowed: HTML (<p>Hello</p>).
category many Text A text label that classifies the entity, such as breakfast for a Meal or car for a PhysicalObject.
contains many MediaObject A media file that is part of the entity, such as an attachment to a Message, the photo in a Post, or the images and videos in a carousel. Each one has its most specific type, such as ImageObject.
description one Text Text that describes an entity, such as a task's notes or a project's summary. It is plain text or Markdown. Not allowed: HTML (<p>Buy milk</p>).
emblem one ImageObject The image an entity presents itself by, such as an avatar, a poster, a cover, a logo, or a favicon. It stands for the entity but is not its content, so changing it does not change the entity. It can be a photograph or any other image. Banners and headers are not emblems.
handle one Text An identifier for an entity within a namespace, such as a username, a channel slug, or a tag label. What it identifies depends on that namespace.
inAccount many Agent or FinancialAccount The account that holds the entity. For an account with a service, it is the agent whose account it is, as that service knows them, such as the owner of an email account a message was delivered to. For a FinancialAccount, it is the account itself, such as the one a FinancialPosting is on or a PaymentCard draws on. An entity held in several accounts is inAccount each. Identifiers an account issues are unique within it.
inRealm one Realm The realm the entity is in, such as the computer system that holds a conversation or a file. Identifiers local to the realm are unique within it.
isPartOf many Entity A whole that the entity is part of, such as a task's project, the page an excerpt comes from, or the transaction a posting belongs to. Seen from the whole, its parts are its hasPart values.
location one Location or Place Where the action happened, or where the entity or event is.
name one Text The name or title of an entity, such as a person's display name, a document's title, or a place's name.
references many Entity An entity this one refers to, such as one it @mentions, a page it links to, or a work it cites.
sameAs many Entity or Text Another reference to the same entity, either an entity or a text reference such as @me. It states that both refer to one thing, not that they are similar or related.
tags many Text A text label for the entity. A label that is an entity of its own is a Tag.
url one URL A URL at which the entity can be found, such as a web page's address or a link to the record in its source.
From Base
source one Text The source that describes the entity or action, such as things-todo. Identifiers such as sourceId are unique within it.
sourceId one Text The identifier the source gives an entity or action, such as a record ID or message ID. It is unique only within its source.

Used as a value

A SoftwareAgent can be the value of these properties.

Examples

An assistant's reply in a coding session

A MessageAction for a reply from an AI assistant.

{
  "@type": "MessageAction",
  "@key": ["@type", "source", "result.sourceId"],
  "source": "claude-code",
  "timestamp": "2026-07-02T10:41:26.000Z",
  "agent": {
    "@type": "SoftwareAgent",
    "@key": ["@type", "source", "handle"],
    "source": "anthropic",
    "handle": "claude",
    "name": "Claude"
  },
  "instrument": [
    {
      "@type": "AIModel",
      "@key": ["@type", "source", "handle"],
      "source": "anthropic",
      "handle": "claude-sonnet-5",
      "name": "claude-sonnet-5"
    }
  ],
  "result": {
    "@type": "Message",
    "@key": ["@type", "source", "sourceId"],
    "source": "claude-code",
    "sourceId": "0b7e4c2a-9f13-4d6b-8a5e-2c1f7d9b3e40",
    "body": "The test fails when the clock crosses midnight UTC. Pinning the date fixes it.",
    "author": [
      {
        "@type": "SoftwareAgent",
        "@key": ["@type", "source", "handle"],
        "source": "anthropic",
        "handle": "claude",
        "name": "Claude"
      }
    ],
    "isPartOf": [
      {
        "@type": "Thread",
        "@key": ["@type", "source", "sourceId"],
        "source": "claude-code",
        "sourceId": "6d2a9e71-3c5b-4f08-b4e2-9a7c1d5f8e26",
        "name": "Fix the flaky date test",
        "isPartOf": [
          {
            "@type": "Project",
            "@key": ["@type", "source", "handle", "inRealm.handle"],
            "source": "claude-code",
            "handle": "/Users/sam/code/garden-planner",
            "name": "/Users/sam/code/garden-planner",
            "inRealm": {
              "@type": "Realm",
              "@key": ["@type", "source", "handle"],
              "source": "hostname",
              "handle": "studio"
            }
          }
        ]
      }
    ]
  }
}

URI https://schema.chronicle.app/SoftwareAgent · Suggest a change

Esc

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