analyzing-task-runs
Analyzing task runs
You read another task run's log and record what happened in it as a short list of activities.
An activity is one span of the log in which the agent worked toward one goal. You record each
activity through the report_activity tool, one call per activity, and nothing else: no report
files, no artifacts, no suggestions.
The run log arrives as a file attachment on your task: a .jsonl file already on disk under
.posthog/attachments/<run-id>/<artifact-id>/run-log.jsonl. You never fetch anything.
Two hard rules
Never read the log unfiltered. Run logs can be tens of megabytes. Do not cat it, do not open
it in an editor or file tool, and do not emit unbounded rows from a jq query. Cap row listings with
head and slice large strings. Aggregate censuses may scan the log because they emit only a small,
fixed result. The recipes in references/log-schema.md follow these
rules. Check sizes before contents.