record_event
Appends a dated event to an append-only log.
Stores kind, text and optional metadata. Text goes through a redaction step and is cut to 4,000 characters. One file per UTC day.
- Tool name
- record_event
- Group
- Memory
- Risk
- low
- Needs approval
- never
- Approval rule
- No approval.
- Allowed in scheduled jobs
- No
- Default
- on
Parameters
| Name | Type | Required | Default | Meaning | Limits |
|---|---|---|---|---|---|
| kind | string | Yes | Short event category. | ||
| text | string | Yes | Text to type or say. | ||
| metadata | object | No | Optional extra fields. |
Returns
A confirmation with the event id.
Example (made up for this page)
{
"kind": "demo",
"text": "demo"
}Recorded event note-1.Side effects
- Appends a line to a JSONL file under data.
How it can fail
| When | What the agent sees |
|---|---|
| The day file is full (about 1 MB) | An error text from the log |
See also:Memory tools
Checked against the source at commit f4fd89f on 29 Oct 2026. Everything here is merged on the main branch; no release has been tagged yet. The source is private, so these pages are the public description.