feat: session replay control with sampling and state management

[abelonogov-ld]

• Added isRunning property to track the current state of session replay.
• Updated start method to accept an ignoreSampling parameter for debugging purposes.
• Refactored isEnabled to manage session replay state more effectively.
• Improved documentation for session replay options, including sampling behavior.

---

Note

Medium Risk
Changes when replay captures run (sampling) and public start/stop semantics; default sampleRate preserves prior always-on behavior but integrators must handle sampledOut and isRunning vs isEnabled.

Overview
Adds probabilistic session replay via a new sampleRate on SessionReplayOptions (default 1.0). Enabling replay or calling start() no longer guarantees capture: the service may return sampledOut and stay off until stop() resets the sampling decision.

SessionReplayStartResult and isRunning separate “enabled / attempted” from “actually recording.” start(ignoreSampling:) can force capture for debugging. LDReplay and the SessionReplay plugin now expose synchronous @MainActor start/stop with a discardable result instead of fire-and-forget Task wrappers.

README documents sampling, result handling, and the debug bypass.

^{Reviewed by Cursor Bugbot for commit 9d48b9b. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 46e6e21. Configure here.}