feat: expose open_im for plugins

machine/plugins/base.py

@@ -388,6 +388,18 @@ async def send_dm_scheduled(
             when, user, text=text, attachments=attachments, blocks=blocks, **kwargs
         )
 
+    async def open_im(self, users: User | str | list[User | str]) -> str:
+        """Open a DM channel with one or more users
+
+        Open a DM channel with one or more users. If the DM channel already exists, the existing channel id
+        will be returned. If the DM channel does not exist, a new channel will be created and the
+        id of the new channel will be returned.
+
+        :param users: :py:class:`~machine.models.user.User` object or id of user to open DM with.
+        :return: id of the DM channel
+        """
+        return await self._client.open_im(users)
+
     def emit(self, event: str, **kwargs: Any) -> None:
         """Emit an event