Server(feat[list_clients]): add list_clients() wrapping tmux list-clients

why: list-clients is needed for monitoring connected clients and
multi-client session management.
what:
- Add Server.list_clients() returning raw stdout lines
- Returns empty list when no clients are attached
- Add test verifying return type

Author: tony

src/libtmux/server.py

@@ -718,6 +718,26 @@ def list_buffers(self) -> list[str]:
 
         return proc.stdout
 
+    def list_clients(self) -> list[str]:
+        """List connected clients via ``$ tmux list-clients``.
+
+        Returns
+        -------
+        list[str]
+            Raw output lines from list-clients.
+
+        Examples
+        --------
+        >>> isinstance(server.list_clients(), list)
+        True
+        """
+        proc = self.cmd("list-clients")
+
+        if proc.stderr:
+            raise exc.LibTmuxException(proc.stderr)
+
+        return proc.stdout
+
     def switch_client(self, target_session: str) -> None:
         """Switch tmux client.
 

tests/test_server.py

@@ -605,6 +605,13 @@ def test_list_buffers(server: Server) -> None:
     assert len(result) >= 2
 
 
+def test_list_clients(server: Server) -> None:
+    """Test Server.list_clients() returns list without error."""
+    server.new_session(session_name="list_clients_test")
+    result = server.list_clients()
+    assert isinstance(result, list)
+
+
 def test_new_session_config_file(
     server: Server,
     tmp_path: pathlib.Path,