profiler.record

Start / stop / check a background profiling recording that spans a play session — the path for "it hitches while I play", which a single live frame can never catch. record("start", label) begins capturing every frame; play or test across as many turns as you like; record("stop", label) ends it and returns the windowed breakdown — avg / p50 / p90 / p99 / max frametime, spike count, and the worst frame's attributed tree. record("status", label) reports an in-progress recording. The read tools that take a source (frame, hotspots, flamegraph) accept a recording's label there; scripts and tasks read the live frame only.