universal-mcp-applications 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

universal_mcp/applications/trello/app.py

@@ -209,9 +209,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def get_actions_id_card(
-        self, id: str, fields: str | None = None
-    ) -> dict[str, Any]:
+    def get_actions_id_card(self, id: str, fields: str | None = None) -> dict[str, Any]:
         """
         Get the Card for an Action
 
@@ -243,9 +241,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def get_actions_id_list(
-        self, id: str, fields: str | None = None
-    ) -> dict[str, Any]:
+    def get_actions_id_list(self, id: str, fields: str | None = None) -> dict[str, Any]:
         """
         Get the List for an Action
 
@@ -2158,9 +2154,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def post_boards_id_boardplugins(
-        self, id: str, idPlugin: str | None = None
-    ) -> Any:
+    def post_boards_id_boardplugins(self, id: str, idPlugin: str | None = None) -> Any:
         """
         Enable a Power-Up on a Board
 
@@ -2849,9 +2843,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def get_cards_id_checkitemstates(
-        self, id: str, fields: str | None = None
-    ) -> Any:
+    def get_cards_id_checkitemstates(self, id: str, fields: str | None = None) -> Any:
         """
         Get checkItems on a Card
 
@@ -3842,9 +3834,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def post_cards_id_labels(
-        self, id: str, color: str, name: str | None = None
-    ) -> Any:
+    def post_cards_id_labels(self, id: str, color: str, name: str | None = None) -> Any:
         """
         Create a new Label on a Card
 
@@ -5525,9 +5515,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def post_enterprises_id_tokens(
-        self, id: str, expiration: str | None = None
-    ) -> Any:
+    def post_enterprises_id_tokens(self, id: str, expiration: str | None = None) -> Any:
         """
         Create an auth Token for an Enterprise.
 
@@ -6340,9 +6328,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def put_lists_id_field(
-        self, id: str, field: str, value: Any | None = None
-    ) -> Any:
+    def put_lists_id_field(self, id: str, field: str, value: Any | None = None) -> Any:
         """
         Update a field on a List
 
@@ -6680,9 +6666,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def get_members_id_actions(
-        self, id: str, filter: str | None = None
-    ) -> list[Any]:
+    def get_members_id_actions(self, id: str, filter: str | None = None) -> list[Any]:
         """
         Get a Member's Actions
 
@@ -8007,9 +7991,7 @@ class TrelloApp(APIApplication):
         except ValueError:
             return None
 
-    def get_members_id_tokens(
-        self, id: str, webhooks: bool | None = None
-    ) -> list[Any]:
+    def get_members_id_tokens(self, id: str, webhooks: bool | None = None) -> list[Any]:
         """
         Get Member's Tokens
 

universal_mcp/applications/twilio/__init__.py

@@ -0,0 +1 @@
+from .app import TwilioApp

universal_mcp/applications/{twillo → twilio}/app.py

@@ -17,13 +17,13 @@ from universal_mcp.exceptions import NotAuthorizedError, ToolError
 from universal_mcp.integrations import Integration
 
 
-class TwillioApp(APIApplication):
+class TwilioApp(APIApplication):
     """
     Application for interacting with the Twilio Messaging API using the official Python SDK.
     """
 
     def __init__(self, integration: Integration, **kwargs: Any) -> None:
-        super().__init__(name="twillio", integration=integration, **kwargs)
+        super().__init__(name="twilio", integration=integration, **kwargs)
         self.base_url = "https://api.twilio.com/2010-04-01"
         self._twilio_client: Any | None = None
         self._account_sid: str | None = None

universal_mcp/applications/twitter/README.md

@@ -13,7 +13,7 @@ This is automatically generated from OpenAPI schema for the TwitterApp API.
 | `create_batch_compliance_job` | Creates a new compliance job using JSON data in the request body and authenticates the request using a Bearer token. |
 | `get_batch_compliance_job` | Retrieves information about a compliance job by its ID using the BearerToken for authentication. |
 | `dm_conversation_id_create` | Creates a new group Direct Message conversation and sends an initial message to the specified participants. |
-| `get_dm_conversations_with_participant_id_dm_events` | Retrieves a list of direct message events for a conversation with a specific participant, allowing for optional filtering by event types and pagination. |
+| `get_dm_convo_with_patcpnts_id_dm_evnts` | Retrieves a list of direct message events for a conversation with a specific participant, allowing for optional filtering by event types and pagination. |
 | `get_dm_conversations_id_dm_events` | Retrieves a list of direct message events for a specified conversation ID, allowing for optional filtering by event types and pagination. |
 | `get_dm_events` | Retrieves a list of direct message events with optional filtering by event types, pagination, and field expansions for media, users, tweets, and DM event details. |
 | `dm_event_delete` | Deletes a DM event by its ID using the DELETE method, requiring authentication via OAuth2UserToken with "dm.read" and "dm.write" scopes or UserToken. |

universal_mcp/applications/twitter/api_segments/dm_conversations_api.py

@@ -49,7 +49,7 @@ class DmConversationsApi(APISegmentBase):
         response.raise_for_status()
         return response.json()
 
-    def get_dm_conversations_with_participant_id_dm_events(
+    def get_dm_convo_with_patcpnts_id_dm_evnts(
         self,
         participant_id,
         max_results=None,
@@ -248,7 +248,7 @@ class DmConversationsApi(APISegmentBase):
     def list_tools(self):
         return [
             self.dm_conversation_id_create,
-            self.get_dm_conversations_with_participant_id_dm_events,
+            self.get_dm_convo_with_patcpnts_id_dm_evnts,
             self.dm_conversation_with_user_event_id_create,
             self.dm_conversation_by_id_event_id_create,
             self.get_dm_conversations_id_dm_events,

universal_mcp/applications/twitter/api_segments/lists_api.py

@@ -27,7 +27,7 @@ class ListsApi(APISegmentBase):
             JSONDecodeError: Raised if the response body cannot be parsed as JSON.
 
         Tags:
-            Lists
+            Lists, important
         """
         request_body_data = None
         request_body_data = {

universal_mcp/applications/unipile/app.py

@@ -3,6 +3,7 @@ from collections.abc import Callable
 from typing import Any, Literal
 
 from loguru import logger
+
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -666,7 +667,10 @@ class UnipileApp(APIApplication):
         keywords: str | None = None,
         sort_by: Literal["relevance", "date"] | None = None,
         date_posted: Literal["past_day", "past_week", "past_month"] | None = None,
-        content_type: Literal["videos", "images", "live_videos", "collaborative_articles", "documents"] | None = None,
+        content_type: Literal[
+            "videos", "images", "live_videos", "collaborative_articles", "documents"
+        ]
+        | None = None,
         posted_by: dict[str, Any] | None = None,
         mentioning: dict[str, Any] | None = None,
         author: dict[str, Any] | None = None,

universal_mcp/applications/whatsapp/app.py

@@ -1,56 +1,57 @@
 from typing import Any
 
 import requests
-from universal_mcp.applications import BaseApplication
-from universal_mcp.exceptions import NotAuthorizedError
-from universal_mcp.integrations import AgentRIntegration
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     WHATSAPP_API_BASE_URL,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     download_media as whatsapp_download_media,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     get_chat as whatsapp_get_chat,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     get_contact_chats as whatsapp_get_contact_chats,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     get_direct_chat_by_contact as whatsapp_get_direct_chat_by_contact,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     get_last_interaction as whatsapp_get_last_interaction,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     get_message_context as whatsapp_get_message_context,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     list_chats as whatsapp_list_chats,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     list_messages as whatsapp_list_messages,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     search_contacts as whatsapp_search_contacts,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     send_audio_message as whatsapp_audio_voice_message,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     send_file as whatsapp_send_file,
 )
-from universal_mcp_whatsapp.whatsapp import (
+from .whatsapp import (
     send_message as whatsapp_send_message,
 )
 
+from universal_mcp.applications.application import BaseApplication
+from universal_mcp.exceptions import NotAuthorizedError
+from universal_mcp.agentr.integration import AgentrIntegration
+
 
 class WhatsappApp(BaseApplication):
     """
     Base class for Universal MCP Applications.
     """
 
-    def __init__(self, integration: AgentRIntegration | None = None, **kwargs) -> None:
+    def __init__(self, integration: AgentrIntegration | None = None, **kwargs) -> None:
         super().__init__(name="whatsapp", integration=integration, **kwargs)
         self.base_url = WHATSAPP_API_BASE_URL
         self._api_key: str = integration.client.api_key if integration else None

universal_mcp/applications/whatsapp/audio.py

@@ -0,0 +1,110 @@
+import os
+import subprocess
+import tempfile
+
+def convert_to_opus_ogg(input_file, output_file=None, bitrate="32k", sample_rate=24000):
+    """
+    Convert an audio file to Opus format in an Ogg container.
+    
+    Args:
+        input_file (str): Path to the input audio file
+        output_file (str, optional): Path to save the output file. If None, replaces the
+                                    extension of input_file with .ogg
+        bitrate (str, optional): Target bitrate for Opus encoding (default: "32k")
+        sample_rate (int, optional): Sample rate for output (default: 24000)
+    
+    Returns:
+        str: Path to the converted file
+        
+    Raises:
+        FileNotFoundError: If the input file doesn't exist
+        RuntimeError: If the ffmpeg conversion fails
+    """
+    if not os.path.isfile(input_file):
+        raise FileNotFoundError(f"Input file not found: {input_file}")
+    
+    # If no output file is specified, replace the extension with .ogg
+    if output_file is None:
+        output_file = os.path.splitext(input_file)[0] + ".ogg"
+    
+    # Ensure the output directory exists
+    output_dir = os.path.dirname(output_file)
+    if output_dir and not os.path.exists(output_dir):
+        os.makedirs(output_dir)
+    
+    # Build the ffmpeg command
+    cmd = [
+        "ffmpeg",
+        "-i", input_file,
+        "-c:a", "libopus",
+        "-b:a", bitrate,
+        "-ar", str(sample_rate),
+        "-application", "voip",  # Optimize for voice
+        "-vbr", "on",           # Variable bitrate
+        "-compression_level", "10",  # Maximum compression
+        "-frame_duration", "60",     # 60ms frames (good for voice)
+        "-y",                        # Overwrite output file if it exists
+        output_file
+    ]
+    
+    try:
+        # Run the ffmpeg command and capture output
+        process = subprocess.run(
+            cmd,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            text=True,
+            check=True
+        )
+        return output_file
+    except subprocess.CalledProcessError as e:
+        raise RuntimeError(f"Failed to convert audio. You likely need to install ffmpeg {e.stderr}")
+
+
+def convert_to_opus_ogg_temp(input_file, bitrate="32k", sample_rate=24000):
+    """
+    Convert an audio file to Opus format in an Ogg container and store in a temporary file.
+    
+    Args:
+        input_file (str): Path to the input audio file
+        bitrate (str, optional): Target bitrate for Opus encoding (default: "32k")
+        sample_rate (int, optional): Sample rate for output (default: 24000)
+    
+    Returns:
+        str: Path to the temporary file with the converted audio
+        
+    Raises:
+        FileNotFoundError: If the input file doesn't exist
+        RuntimeError: If the ffmpeg conversion fails
+    """
+    # Create a temporary file with .ogg extension
+    temp_file = tempfile.NamedTemporaryFile(suffix=".ogg", delete=False)
+    temp_file.close()
+    
+    try:
+        # Convert the audio
+        convert_to_opus_ogg(input_file, temp_file.name, bitrate, sample_rate)
+        return temp_file.name
+    except Exception as e:
+        # Clean up the temporary file if conversion fails
+        if os.path.exists(temp_file.name):
+            os.unlink(temp_file.name)
+        raise e
+
+
+if __name__ == "__main__":
+    # Example usage
+    import sys
+    
+    if len(sys.argv) < 2:
+        print("Usage: python audio.py input_file [output_file]")
+        sys.exit(1)
+    
+    input_file = sys.argv[1]
+    
+    try:
+        result = convert_to_opus_ogg_temp(input_file)
+        print(f"Successfully converted to: {result}")
+    except Exception as e:
+        print(f"Error: {e}")
+        sys.exit(1)