Tree inspection

Nexus includes helper methods to inspect stored events after they are persisted.

Fetch events

events = client.get_all_events()

You can pass a specific trace_id:

events = client.get_all_events(trace_id="your-trace-id")

client.print_tree_structure()

This prints a terminal tree grouped by parent_run_id relationships and colorized by event category.

tree_data = client.build_tree_data_from_events()

Use this when you want custom rendering or downstream processing.

tree_str = client.get_trace_tree_string()

This returns a structured text representation designed for agent or LLM consumption.