Function run_session 

pub fn run_session(
    socket_path: &str,
    channel: &str,
    cmd: &[String],
) -> Result<()>

Connect to a term-session gateway and run the TUI viewer for channel.

This function is synchronous. It creates a background tokio runtime for muxio IPC, attaches to the gateway channel, spawns/joins the session, then runs the synchronous crossterm event loop on the calling thread.

socket_path is the gateway channel name (the muxio socket identity); channel is the logical channel to attach to; cmd is the command to run (empty = the gateway’s default shell). PTY geometry is read from the real terminal.