universal-mcp-applications 0.1.13__py3-none-any.whl → 0.1.14__py3-none-any.whl

universal_mcp/applications/fireflies/app.py

@@ -20,23 +20,23 @@ class FirefliesApp(GraphQLApplication):
         )
         self.integration = integration
 
-    def get_team_analytics(
+    def get_team_conversation_analytics(
         self, start_time: str | None = None, end_time: str | None = None
     ) -> dict[str, Any]:
         """
-        Fetches team analytics data within a specified time range.
-
+        Queries the Fireflies.ai API for team conversation analytics, specifically the average number of filler words. The data retrieval can optionally be filtered by a start and end time. Returns a dictionary containing the fetched analytics.
+        
         Args:
             start_time: Optional start time for analytics (ISO 8601 format, e.g., "2024-01-01T00:00:00Z").
             end_time: Optional end time for analytics (ISO 8601 format, e.g., "2024-01-31T23:59:59Z").
-
+        
         Returns:
             A dictionary containing team analytics data.
             Example: {"team": {"conversation": {"average_filler_words": 0.5}}}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             analytics, team, fireflies, query
         """
@@ -60,20 +60,20 @@ class FirefliesApp(GraphQLApplication):
         result = self.query(query_gql, variables=variables if variables else None)
         return result.get("analytics", {})
 
-    def get_ai_apps_outputs(self, transcript_id: str) -> list[dict[str, Any]]:
+    def get_transcript_ai_outputs(self, transcript_id: str) -> list[dict[str, Any]]:
         """
-        Fetches AI Apps outputs for a given transcript.
-
+        Retrieves all AI-generated application outputs, such as summaries or analyses, associated with a specific transcript ID. It fetches the detailed prompt and response data for each AI app that has processed the transcript, providing a complete record of AI-generated content.
+        
         Args:
             transcript_id: The ID of the transcript.
-
+        
         Returns:
             A list of dictionaries, each representing an AI app output.
             Example: [{"transcript_id": "...", "user_id": "...", ...}]
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             ai, apps, transcript, fireflies, query
         """
@@ -98,18 +98,18 @@ class FirefliesApp(GraphQLApplication):
 
     def get_user_details(self, user_id: str) -> dict[str, Any]:
         """
-        Fetches details for a specific user.
-
+        Fetches details, such as name and integrations, for a single user identified by their unique ID. This function queries for a specific user, differentiating it from `list_users` which retrieves a list of all users in the workspace.
+        
         Args:
             user_id: The ID of the user.
-
+        
         Returns:
             A dictionary containing user details (e.g., name, integrations).
             Example: {"name": "John Doe", "integrations": [...]}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             user, details, fireflies, query, important
         """
@@ -127,15 +127,15 @@ class FirefliesApp(GraphQLApplication):
 
     def list_users(self) -> list[dict[str, Any]]:
         """
-        Fetches a list of users in the workspace.
-
+        Retrieves a list of all users in the workspace, returning each user's name and configured integrations. It provides a complete team roster, differing from `get_user_details`, which fetches information for a single user by their ID.
+        
         Returns:
             A list of dictionaries, each representing a user with their name and integrations.
             Example: [{"name": "Justin Fly", "integrations": ["zoom", "slack"]}, ...]
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             user, list, users, fireflies, query
         """
@@ -157,18 +157,18 @@ class FirefliesApp(GraphQLApplication):
 
     def get_transcript_details(self, transcript_id: str) -> dict[str, Any]:
         """
-        Fetches details for a specific transcript.
-
+        Queries the Fireflies API for a single transcript's details, such as title and ID, using its unique identifier. It fetches one specific entry, distinguishing it from `list_transcripts`, which retrieves a collection, and from `get_ai_apps_outputs` which gets AI data from a transcript.
+        
         Args:
             transcript_id: The ID of the transcript.
-
+        
         Returns:
             A dictionary containing transcript details (e.g., title, id).
             Example: {"title": "Meeting Notes", "id": "..."}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             transcript, details, fireflies, query, important
         """
@@ -186,18 +186,18 @@ class FirefliesApp(GraphQLApplication):
 
     def list_transcripts(self, user_id: str | None = None) -> list[dict[str, Any]]:
         """
-        Fetches a list of transcripts, optionally filtered by user ID.
-
+        Fetches a list of meeting transcripts, returning the title and ID for each. The list can be filtered to return only transcripts for a specific user. This function complements `get_transcript_details`, which retrieves a single transcript by its unique ID.
+        
         Args:
             user_id: Optional ID of the user to filter transcripts for.
-
+        
         Returns:
             A list of dictionaries, each representing a transcript (e.g., title, id).
             Example: [{"title": "Meeting 1", "id": "..."}, {"title": "Meeting 2", "id": "..."}]
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             transcript, list, fireflies, query
         """
@@ -217,18 +217,18 @@ class FirefliesApp(GraphQLApplication):
 
     def get_bite_details(self, bite_id: str) -> dict[str, Any]:
         """
-        Fetches details for a specific bite (soundbite/clip).
-
+        Retrieves detailed information for a specific bite (soundbite/clip) using its unique ID. It fetches data including the user ID, name, processing status, and summary. This provides a focused view of a single bite, distinguishing it from `list_bites` which fetches a collection of bites.
+        
         Args:
             bite_id: The ID of the bite.
-
+        
         Returns:
             A dictionary containing bite details (e.g., user_id, name, status, summary).
             Example: {"user_id": "...", "name": "Key Moment", "status": "processed", "summary": "..."}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             bite, details, fireflies, query
         """
@@ -248,18 +248,18 @@ class FirefliesApp(GraphQLApplication):
 
     def list_bites(self, mine: bool | None = None) -> list[dict[str, Any]]:
         """
-        Fetches a list of bites, optionally filtered to the current user's bites.
-
+        Retrieves a list of soundbites (clips) from the Fireflies API. An optional 'mine' parameter filters for soundbites belonging only to the authenticated user. Differentiates from 'get_bite_details' by fetching multiple items rather than a single one by ID.
+        
         Args:
             mine: Optional boolean to filter for the authenticated user's bites (default true if not specified by API).
-
+        
         Returns:
             A list of dictionaries, each representing a bite (e.g., user_id, name, end_time).
             Example: [{"user_id": "...", "name": "Clip 1", "end_time": "..."}]
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             bite, list, fireflies, query
         """
@@ -282,18 +282,18 @@ class FirefliesApp(GraphQLApplication):
 
     def add_to_live_meeting(self, meeting_link: str) -> dict[str, Any]:
         """
-        Adds Fireflies.ai to a live meeting.
-
+        Executes a GraphQL mutation to make the Fireflies.ai notetaker join a live meeting specified by its URL. This action initiates the bot's recording and transcription process for the ongoing session and returns a success confirmation.
+        
         Args:
             meeting_link: The URL of the live meeting (e.g., Google Meet link).
-
+        
         Returns:
             A dictionary indicating the success of the operation.
             Example: {"success": true}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             meeting, live, fireflies, mutation, important
         """
@@ -308,24 +308,24 @@ class FirefliesApp(GraphQLApplication):
         result = self.mutate(mutation_gql, variables=variables)
         return result.get("addToLiveMeeting", {})
 
-    def create_bite(
+    def create_soundbite_from_transcript(
         self, transcript_id: str, start_time: float, end_time: float
     ) -> dict[str, Any]:
         """
-        Creates a bite (soundbite/clip) from a transcript.
-
+        Creates a soundbite/clip from a specified segment of a transcript using its ID, start, and end times. This function executes a GraphQL mutation, returning details of the newly created bite, such as its ID and processing status.
+        
         Args:
             transcript_id: The ID of the transcript.
             start_time: The start time of the bite in seconds (or relevant float unit).
             end_time: The end time of the bite in seconds (or relevant float unit).
-
+        
         Returns:
             A dictionary containing details of the created bite (e.g., summary, status, id).
             Example: {"summary": "...", "status": "processing", "id": "..."}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             bite, create, transcript, fireflies, mutation
         """
@@ -348,18 +348,18 @@ class FirefliesApp(GraphQLApplication):
 
     def delete_transcript(self, transcript_id: str) -> dict[str, Any]:
         """
-        Deletes a transcript.
-
+        Permanently deletes a specific transcript from Fireflies.ai using its ID. This destructive operation executes a GraphQL mutation and returns a dictionary containing the details of the transcript (e.g., title, date) as it existed just before being removed, confirming the action.
+        
         Args:
             transcript_id: The ID of the transcript to delete.
-
+        
         Returns:
             A dictionary containing details of the deleted transcript.
             Example: {"title": "Old Meeting", "date": "...", "duration": ..., "organizer_email": "..."}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             transcript, delete, fireflies, mutation, destructive
         """
@@ -379,19 +379,19 @@ class FirefliesApp(GraphQLApplication):
 
     def set_user_role(self, user_id: str, role: str) -> dict[str, Any]:
         """
-        Sets the role for a user.
-
+        Assigns a new role (e.g., 'admin', 'member') to a user specified by their ID. This function executes a GraphQL mutation to modify user data and returns a dictionary with the user's updated name and admin status to confirm the change.
+        
         Args:
             user_id: The ID of the user.
             role: The role to assign (e.g., "admin", "member").
-
+        
         Returns:
             A dictionary containing the updated user details (e.g., name, is_admin).
             Example: {"name": "Jane Doe", "is_admin": true}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             user, role, admin, fireflies, mutation
         """
@@ -407,28 +407,28 @@ class FirefliesApp(GraphQLApplication):
         result = self.mutate(mutation_gql, variables=variables)
         return result.get("setUserRole", {})
 
-    def upload_audio(
+    def transcribe_audio_from_url(
         self,
         url: str,
         title: str | None = None,
         attendees: list[dict[str, str]] | None = None,
     ) -> dict[str, Any]:
         """
-        Uploads an audio file for transcription.
-
+        Submits an audio file from a URL to the Fireflies.ai API for transcription. It can optionally associate a title and a list of attendees with the audio, returning the upload status and details upon completion.
+        
         Args:
             url: The URL of the audio file.
             title: Optional title for the uploaded audio.
             attendees: Optional list of attendees. Each attendee is a dict
                        with "displayName", "email", "phoneNumber".
-
+        
         Returns:
             A dictionary indicating the success and details of the upload.
             Example: {"success": true, "title": "Uploaded Audio", "message": "..."}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             audio, upload, transcript, fireflies, mutation
         """
@@ -451,23 +451,23 @@ class FirefliesApp(GraphQLApplication):
         result = self.mutate(mutation_gql, variables=variables)
         return result.get("uploadAudio", {})
 
-    def update_meeting_title(
+    def update_transcript_title(
         self, transcript_id: str, new_title: str
     ) -> dict[str, Any]:
         """
-        Updates the title of a meeting (transcript).
-
+        Updates the title of a specific transcript, identified by its ID, to a new value. This function executes a GraphQL mutation and returns a dictionary containing the newly assigned title upon successful completion of the request.
+        
         Args:
             transcript_id: The ID of the transcript to update.
             new_title: The new title for the meeting.
-
+        
         Returns:
             A dictionary containing the updated title.
             Example: {"title": "New Meeting Title"}
-
+        
         Raises:
             Exception: If the API request fails.
-
+        
         Tags:
             transcript, meeting, title, update, fireflies, mutation
         """
@@ -490,8 +490,8 @@ class FirefliesApp(GraphQLApplication):
             A list of callable tool methods.
         """
         return [
-            self.get_team_analytics,
-            self.get_ai_apps_outputs,
+            self.get_team_conversation_analytics,
+            self.get_transcript_ai_outputs,
             self.get_user_details,
             self.list_users,
             self.get_transcript_details,
@@ -499,9 +499,9 @@ class FirefliesApp(GraphQLApplication):
             self.get_bite_details,
             self.list_bites,
             self.add_to_live_meeting,
-            self.create_bite,
+            self.create_soundbite_from_transcript,
             self.delete_transcript,
             self.set_user_role,
-            self.upload_audio,
-            self.update_meeting_title,
+            self.transcribe_audio_from_url,
+            self.update_transcript_title,
         ]