# Actor

> Who did something.

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

```json
{
  "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"
  }
}
```
