Actor

Who did something. Agent actions name the agent token and the human who owns it, shown as “via agent X”.

Fields

Field	Type	Description
type *	user, agent, system, ai_ops, github, stripe
id *	string	usr_… for users, tok_… for agent tokens, a component or agent name for system and ai_ops.
display *	string	Ready-to-show text.
via_agent	object or null	Present when an agent token acted on a human’s behalf.
on_behalf_of	object or null	The human who owns the agent token.

* always present

Example

{
  "type": "agent",
  "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
  "display": "Stewart Webb via agent claude-code-on-stewart-laptop",
  "via_agent": {
    "id": "tok_01jbx2m9k7q4r8t5v6w3y0z1tk",
    "name": "claude-code-on-stewart-laptop"
  },
  "on_behalf_of": {
    "id": "usr_01jbx2m9k7q4r8t5v6w3y0z1us",
    "display": "Stewart Webb"
  }
}