What the metadata path stores
For agent-run events, HeadsDown stores bounded facts that help explain what happened and whether the call worked. Those facts are categories, counts, buckets, booleans, timestamps, opaque identifiers, call keys, action keys, reason codes, validation status, and outcome metadata.
- Run and client metadata
- Event type, schema version, run id, source, client kind/name/version, actor kind, `metadata_only` privacy mode, and idempotency key.
- Task and progress metadata
- Task category, task size bucket, elapsed seconds, tool-call counts, file-count buckets, validation level, validation status, retry count, scope-changed flag, and progress state.
- Calls, actions, and outcomes
- HeadsDown call keys, action keys, reason codes, queue/continuation identifiers, deferred-decision categories, outcome keys, feedback keys, and value-evidence references.