MediumObservabilityPython 3

Agent Event Timeline

Build a reviewable append-only timeline for cloud-agent run events.

35m2 sample tests5 hidden tests

Implement EventTimeline, an append-only event log for agent runs.

Requirements

  • append(run_id, kind, timestamp, message) stores an event and returns its sequence number.
  • Sequence numbers are global and start at 1.
  • list_events(run_id, after_seq=0, limit=100) returns events for one run with seq > after_seq.
  • Output events are dictionaries with seq, kind, timestamp, and message.
  • Messages must redact tokens matching sk- followed by letters, digits, _, or -.
  • Results are ordered by sequence and respect limit.

Example

python
1timeline = EventTimeline() 2timeline.append("r1", "log", 1.0, "started") 3assert timeline.list_events("r1")[0]["message"] == "started"

Constraints

  • Keep state in memory.
  • Never expose events from other runs.

Editor