test(profiler): Wait for automatic shutdown (#7364)

The automatic profiler lifecycle shuts down asynchronously after
inactive profiles are observed by the sampler. Replace the fixed 200 ms
sleeps with a bounded wait for both shutdown and the resulting profile
chunk, so loaded CI workers cannot race the assertion.

<!-- junior-request-attribution:start -->
Requested by **neel**.
<!-- junior-request-attribution:end -->

<!-- junior-session-footer:start -->
<!-- junior-conversation-id:slack%3AC09M26BC6A1%3A1788434448.544309 -->

--

[View Junior
Session](https://junior-prod.sentry.dev/conversations/slack%3AC09M26BC6A1%3A1788434448.544309)
[[Sentry]](https://sentry.sentry.io/explore/conversations/slack%3AC09M26BC6A1%3A1788434448.544309/?project=4510944073809921)

<!-- junior-session-footer:end -->

Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
Co-authored-by: Neel Shah <6536764+sl0thentr0py@users.noreply.github.com>

Author: sentry-junior[bot]

tests/profiler/test_continuous_profiler.py

@@ -27,6 +27,27 @@
 requires_gevent = pytest.mark.skipif(gevent is None, reason="gevent not enabled")
 
 
+def wait_for_profiler_to_stop(envelopes, timeout=1.0):
+    deadline = time.monotonic() + timeout
+    while time.monotonic() < deadline:
+        profiler_stopped = get_profiler_id() is None
+        profile_flushed = any(
+            item.type == "profile_chunk"
+            for envelope in envelopes
+            for item in envelope.items
+        )
+        if profiler_stopped and profile_flushed:
+            return
+        time.sleep(0.01)
+
+    assert get_profiler_id() is None, "profiler should not be running"
+    assert any(
+        item.type == "profile_chunk"
+        for envelope in envelopes
+        for item in envelope.items
+    ), "profiler should have flushed a profile chunk"
+
+
 def get_client_options(use_top_level_profiler_mode):
     def client_options(
         mode=None, auto_start=None, profile_session_sample_rate=1.0, lifecycle="manual"
@@ -807,9 +828,7 @@ def test_continuous_profiler_auto_start_and_stop_sampled(
             assert profiler_id is not None, "profiler should be running"
             profiler_ids.add(profiler_id)
 
-        # wait at least 1 cycle for the profiler to stop
-        time.sleep(0.2)
-        assert get_profiler_id() is None, "profiler should not be running"
+        wait_for_profiler_to_stop(envelopes)
 
         assert len(profiler_ids) == 1
         all_profiler_ids.add(profiler_ids.pop())
@@ -891,9 +910,7 @@ def test_continuous_profiler_auto_start_and_stop_sampled_span_streaming(
             assert profiler_id is not None, "profiler should be running"
             profiler_ids.add(profiler_id)
 
-        # wait at least 1 cycle for the profiler to stop
-        time.sleep(0.2)
-        assert get_profiler_id() is None, "profiler should not be running"
+        wait_for_profiler_to_stop(envelopes)
 
         assert len(profiler_ids) == 1
         all_profiler_ids.add(profiler_ids.pop())