blueclaw

Event ledger

The event ledger is the append-only list of events that belong to one task run.

Every model call, tool call, approval, tool exposure decision and launch step lands in it, which makes it the place to reconstruct what happened. Event names follow a fixed grammar declared in bluecollar's agentcontract/task_event_name.go and generated into protocol/ as task-event-name: for example tool.<name>.requested, tool.<name>.result, approval.pending_call, approval.executed, agent.instructions_loaded and llm.call.

GET /admin/api/run/detail?taskRunID=<id> returns a run with its ledger, and GET /tasks/api/events streams one person's events over SSE.