feat(gamescope): end dedicated stream on Steam game exit + auto --steam

Dedicated single-game sessions now end cleanly when the launched game quits, and Steam launches get gamescope's Steam integration without an operator env knob. End-on-exit: the existing APP_EXITED close only fired when gamescope's PipeWire node vanished, which never happens for Steam — the nested `steam` is the resident singleton client and stays up after a game quits, so gamescope (and its node) never die and the stream sat on a hidden Steam session forever. Add a Steam AppId reaper watcher (pf-vdisplay .../gamescope/discovery.rs): steam_appid_from_launch() parses steam://rungameid/<id>; wait_for_steam_game_exit() waits for the game to start (<=300s grace) then exit (3s confirm); steam_game_running() scans same-uid /proc for Steam's launch reaper matching both the `SteamLaunch` and `AppId=<id>` argv tokens (exact-match; reaper lifetime == game lifetime, so shader precompile can't false-trigger). The host spawns a pf1-gamewatch thread for nested Steam launches that closes the connection with APP_EXITED (launcher clients return to their library) and sets quit/stop; cancelled via stop if the session ends first. Non-Steam nested launches keep the node-death path (gamescope's child IS the game). Flags: auto-enable `--steam` whenever the launch is a Steam launch (was only the global PUNKTFUNK_GAMESCOPE_STEAM knob, default-off) — in-game overlay / Steam+X / gamepad-UI nav for Steam titles with no operator config. New opt-in PUNKTFUNK_GAMESCOPE_GRAB_CURSOR adds `--force-grab-cursor` for a real game launch (FPS mouselook); default OFF because it forces relative mode, which breaks absolute-pointer games/menus. Verified: fmt clean; clippy -D warnings clean on the three crates; pf-vdisplay 64/0 (incl. new steam-appid parse test); punktfunk-host builds + 186/0; reaper /proc detection smoke-tested (detect, exact non-match, gone-after-exit). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-18 16:24:34 +02:00
parent 770994b7aa
commit b89dbfa979
6 changed files with 246 additions and 11 deletions
@@ -176,6 +176,28 @@ pub fn dedicated_game_exited(_node_id: u32) -> bool {
    false
 }

+/// The Steam appid a dedicated launch targets (`steam … steam://rungameid/<appid>`), for the
+/// game-exit watcher. `None` for a non-Steam launch (those are covered by the node-death path
+/// [`dedicated_game_exited`] — gamescope's nested child IS the game). See
+/// [`gamescope::steam_appid_from_launch`].
+#[cfg(target_os = "linux")]
+pub fn steam_appid_from_launch(cmd: &str) -> Option<u32> {
+    gamescope::steam_appid_from_launch(cmd)
+}
+
+/// Block until the dedicated Steam game `appid` has started and then exited — returns `true` when the
+/// session should end cleanly (APP_EXITED). Returns `false` if `cancel` is set (the session ended for
+/// another reason) or the game never started within the startup grace (leave the session up). Runs on
+/// the host's per-session watch thread; `cancel` is the session's stop flag. See
+/// [`gamescope::wait_for_steam_game_exit`].
+#[cfg(target_os = "linux")]
+pub fn watch_steam_game_exit(appid: u32, cancel: &std::sync::atomic::AtomicBool) -> bool {
+    matches!(
+        gamescope::wait_for_steam_game_exit(appid, cancel),
+        gamescope::SteamGameWatch::Exited
+    )
+}
+
 /// Cancel any pending TV-session restore because a client (re)connected (review #3). No-op off Linux.
 #[cfg(target_os = "linux")]
 pub fn cancel_pending_tv_restore() {