universal-mcp-applications 0.1.30__py3-none-any.whl → 0.1.36rc1__py3-none-any.whl

universal_mcp/applications/google_docs/app.py

@@ -1,5 +1,4 @@
 from typing import Any
-
 from universal_mcp.applications.application import APIApplication
 from universal_mcp.integrations import Integration
 
@@ -9,20 +8,20 @@ class GoogleDocsApp(APIApplication):
         super().__init__(name="google_docs", integration=integration)
         self.base_api_url = "https://docs.googleapis.com/v1/documents"
 
-    def create_document(self, title: str) -> dict[str, Any]:
+    async def create_document(self, title: str) -> dict[str, Any]:
         """
-        Creates a blank Google Document with a specified title by sending a POST request to the Google Docs API. The function returns a dictionary containing the new document's metadata, including the unique document ID required by other functions for subsequent modifications or retrieval.
-        
+        Creates a blank Google Document with a specified title by sending a POST request to the Google Docs API. The function returns a dictionary containing the new document's metadata, including the unique document ID required by other functions for subsequent modifications or retrieval. Note that you need to call other google_docs functions (e.g. `google_docs__insert_text`) to actually add content after creating the document.
+
         Args:
             title: The title for the new Google Document to be created.
-        
+
         Returns:
             A dictionary containing the response from the Google Docs API with document details and metadata.
-        
+
         Raises:
             HTTPError: If the API request fails due to network issues, authentication errors, or invalid parameters.
             RequestException: If there are connection errors or timeout issues during the API request.
-        
+
         Tags:
             create, document, api, important, google-docs, http
         """
@@ -30,22 +29,24 @@ class GoogleDocsApp(APIApplication):
         document_data = {"title": title}
         response = self._post(url, data=document_data)
         response.raise_for_status()
-        return response.json()
+        payload = response.json()
+        payload["Note"] = "You must load and call other google docs content functions (like google_docs__insert_text)"
+        return payload
 
     def get_document(self, document_id: str) -> dict[str, Any]:
         """
         Retrieves the complete, raw JSON object for a Google Document by its ID. This function returns the full, unprocessed API response with all metadata and structural elements, distinguishing it from `get_document_content`, which parses this data to extract only the title and plain text.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to retrieve.
-        
+
         Returns:
             A dictionary containing the complete document data as returned by the Google Docs API.
-        
+
         Raises:
             HTTPError: If the API request fails or the specified document cannot be found.
             JSONDecodeError: If the API response is not valid JSON and cannot be parsed.
-        
+
         Tags:
             retrieve, read, api, document, google-docs, important
         """
@@ -53,7 +54,7 @@ class GoogleDocsApp(APIApplication):
         response = self._get(url)
         return response.json()
 
-    def get_document_content(self, document_id: str) -> dict[str, Any]:
+    async def get_document_content(self, document_id: str) -> dict[str, Any]:
         """
         Retrieves and converts a Google Docs document into Markdown-formatted content.
 
@@ -90,7 +91,6 @@ class GoogleDocsApp(APIApplication):
         inline_objects = response.get("inlineObjects", {})
         lists = response.get("lists", {})
         footnotes_data = response.get("footnotes", {})
-
         text_chunks: list[str] = []
         footnotes: dict[str, str] = {}
         footnote_index: dict[str, int] = {}
@@ -132,7 +132,7 @@ class GoogleDocsApp(APIApplication):
             """Returns appropriate Markdown heading level."""
             style = paragraph.get("paragraphStyle", {})
             heading = style.get("namedStyleType", "")
-            match = re.match(r"HEADING_(\d)", heading)
+            match = re.match("HEADING_(\\d)", heading)
             if match:
                 level = int(match.group(1))
                 return "#" * level
@@ -147,7 +147,6 @@ class GoogleDocsApp(APIApplication):
             nesting = paragraph["bullet"].get("nestingLevel", 0)
             list_info = lists.get(list_id, {})
             list_type = list_info.get("listProperties", {}).get("nestingLevels", [{}])[nesting].get("glyphType")
-
             indent = "  " * nesting
             if list_type and "DECIMAL" in list_type:
                 current_list_counters[list_id] = current_list_counters.get(list_id, 1)
@@ -177,10 +176,8 @@ class GoogleDocsApp(APIApplication):
                 if "equation" in para:
                     text_chunks.append(extract_equation(para))
                     continue
-
                 heading_md = extract_heading_style(para)
                 list_prefix = extract_list_prefix(para)
-
                 para_text = extract_text_from_paragraph(para).strip()
                 if para_text:
                     if heading_md:
@@ -189,69 +186,50 @@ class GoogleDocsApp(APIApplication):
                         text_chunks.append(f"{list_prefix}{para_text}")
                     else:
                         text_chunks.append(para_text)
-
             elif "table" in element:
                 table_md = extract_table(element["table"])
                 text_chunks.append(table_md)
-
             elif "horizontalRule" in element:
                 text_chunks.append("\n---\n")
-
             elif "tableOfContents" in element:
                 text_chunks.append("<!-- Table of Contents -->")
-
-            # Handle footnote references (inline elements)
             elif "footnoteReference" in element:
                 footnote_id = element["footnoteReference"]["footnoteId"]
                 ref = extract_footnote_ref(footnote_id)
                 text_chunks.append(ref)
-
-        # Append footnotes at the end
         if footnotes:
             text_chunks.append("\n## Footnotes\n")
             for fid, index in sorted(footnote_index.items(), key=lambda x: x[1]):
                 text_chunks.append(f"[^{index}]: {footnotes[fid]}")
+        content = "\n\n".join((chunk.strip() for chunk in text_chunks if chunk.strip()))
+        return {"title": title, "content": content}
 
-        content = "\n\n".join(chunk.strip() for chunk in text_chunks if chunk.strip())
-
-        return {
-            "title": title,
-            "content": content
-        }
-
-
-    def insert_text(
-        self, document_id: str, content: str, index: int = 1
-    ) -> dict[str, Any]:
+    async def insert_text(self, document_id: str, content: str, index: int = 1) -> dict[str, Any]:
         """
         Inserts a text string at a specified index within a Google Document using the batchUpdate API. Unlike functions that format existing text or delete content ranges, this method specifically adds new textual content to the document body.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             content: The text content to be inserted into the document.
             index: The zero-based position in the document where the text should be inserted (default is 1).
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the batch update operation.
-        
+
         Raises:
             HTTPError: If the API request fails, for example due to invalid document_id or insufficient permissions.
             RequestException: If there are network connectivity issues or problems contacting the API endpoint.
-        
+
         Tags:
             update, insert, document, api, google-docs, batch, content-management, important
         """
         url = f"{self.base_api_url}/{document_id}:batchUpdate"
-        batch_update_data = {
-            "requests": [
-                {"insertText": {"location": {"index": index}, "text": content}}
-            ]
-        }
+        batch_update_data = {"requests": [{"insertText": {"location": {"index": index}, "text": content}}]}
         response = self._post(url, data=batch_update_data)
         response.raise_for_status()
         return response.json()
 
-    def apply_text_style(
+    async def apply_text_style(
         self,
         document_id: str,
         start_index: int,
@@ -266,7 +244,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Applies character-level formatting (e.g., bold, italic, color, links) to a specified text range. This function modifies text attributes directly, distinguishing it from `update_paragraph_style` which handles block-level properties like alignment.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to update.
             start_index: The zero-based start index of the text range to apply the style.
@@ -278,14 +256,14 @@ class GoogleDocsApp(APIApplication):
             link_url: URL to apply as a hyperlink to the text.
             foreground_color: RGB color dictionary with 'red', 'green', and 'blue' floats (0.0 to 1.0) for the text color.
             background_color: RGB color dictionary with 'red', 'green', and 'blue' floats (0.0 to 1.0) for the text background color.
-        
+
         Returns:
             A dictionary containing the Google Docs API response, or a message if no styling was applied.
-        
+
         Raises:
             HTTPError: If the Google Docs API request fails.
             RequestException: If there are network connectivity issues during the API request.
-        
+
         Tags:
             style, format, text, document, api, google-docs, important
         """
@@ -345,7 +323,7 @@ class GoogleDocsApp(APIApplication):
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def update_paragraph_style(
+    async def update_paragraph_style(
         self,
         document_id: str,
         start_index: int,
@@ -359,7 +337,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Applies paragraph-level formatting like alignment, named styles (e.g., 'HEADING_1'), and text direction to a text range in a Google Doc. Distinct from `apply_text_style`, which handles character formatting, this method modifies properties for entire paragraphs using the batchUpdate API.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to update.
             start_index: The zero-based start index of the paragraph range to style.
@@ -370,14 +348,14 @@ class GoogleDocsApp(APIApplication):
             spacing_mode: Spacing mode for the paragraph ('NEVER_COLLAPSE', 'COLLAPSE_LISTS').
             segment_id: Optional segment ID for the text range.
             tab_id: Optional tab ID for the text range.
-        
+
         Returns:
             A dictionary containing the API response from the Google Docs batchUpdate request.
-        
+
         Raises:
             HTTPError: If the API request to update the document fails due to an HTTP error.
             RequestException: If there are network connectivity issues during the API request.
-        
+
         Tags:
             style, format, paragraph, document, api, google-docs, batch, content-management, important
         """
@@ -405,50 +383,37 @@ class GoogleDocsApp(APIApplication):
             range_obj["tabId"] = tab_id
         batch_update_data = {
             "requests": [
-                {
-                    "updateParagraphStyle": {
-                        "range": range_obj,
-                        "paragraphStyle": paragraph_style,
-                        "fields": ",".join(fields_to_update),
-                    }
-                }
+                {"updateParagraphStyle": {"range": range_obj, "paragraphStyle": paragraph_style, "fields": ",".join(fields_to_update)}}
             ]
         }
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def delete_content_range(
-        self,
-        document_id: str,
-        start_index: int,
-        end_index: int,
-        segment_id: str | None = None,
-        tab_id: str | None = None,
+    async def delete_content_range(
+        self, document_id: str, start_index: int, end_index: int, segment_id: str | None = None, tab_id: str | None = None
     ) -> dict[str, Any]:
         """
         Removes content from a specified index range in a Google Document via the batchUpdate API. Unlike functions that delete entire elements (e.g., `delete_header`), this provides granular control by targeting content based on its precise start and end location, optionally within a specific segment or tab.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             start_index: The zero-based start index of the content range to delete.
             end_index: The zero-based end index of the content range to delete (exclusive).
             segment_id: Optional; the ID of the header, footer, or footnote segment containing the content.
             tab_id: Optional; the ID of the tab containing the content to delete.
-        
+
         Returns:
             A dictionary representing the Google Docs API response after performing the delete operation.
-        
+
         Raises:
             HTTPError: Raised when the API request fails due to issues such as invalid document ID or insufficient permissions.
             RequestException: Raised when there are network connectivity issues or problems with the API endpoint.
-        
+
         Tags:
             delete, remove, content, document, api, google-docs, batch, content-management, important
         """
         url = f"{self.base_api_url}/{document_id}:batchUpdate"
-        delete_request: dict[str, Any] = {
-            "range": {"startIndex": start_index, "endIndex": end_index}
-        }
+        delete_request: dict[str, Any] = {"range": {"startIndex": start_index, "endIndex": end_index}}
         if segment_id is not None:
             delete_request["range"]["segmentId"] = segment_id
         if tab_id is not None:
@@ -457,18 +422,12 @@ class GoogleDocsApp(APIApplication):
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def insert_table(
-        self,
-        document_id: str,
-        location_index: int,
-        rows: int,
-        columns: int,
-        segment_id: str = None,
-        tab_id: str = None,
+    async def insert_table(
+        self, document_id: str, location_index: int, rows: int, columns: int, segment_id: str = None, tab_id: str = None
     ) -> dict[str, Any]:
         """
         Inserts a table with specified rows and columns at a given index in a Google Document using the batchUpdate API. It can optionally place the table within specific document segments, such as headers or footers, handling structural additions rather than text or style modifications.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             location_index: The zero-based index within the document body or segment where the table should be inserted.
@@ -476,14 +435,14 @@ class GoogleDocsApp(APIApplication):
             columns: The number of columns the inserted table should have.
             segment_id: Optional ID of the header, footer, or footnote segment where the table will be inserted (if applicable).
             tab_id: Optional ID of the tab containing the insertion location.
-        
+
         Returns:
             A dictionary containing the response from the Google Docs API after performing the table insertion.
-        
+
         Raises:
             HTTPError: Raised when the API request fails due to reasons such as invalid document ID or insufficient permissions.
             RequestException: Raised when there are network connectivity issues or problems reaching the API endpoint.
-        
+
         Tags:
             table, insert, document, api, google-docs, batch, content-management, important
         """
@@ -493,21 +452,11 @@ class GoogleDocsApp(APIApplication):
             location["segmentId"] = segment_id
         if tab_id is not None:
             location["tabId"] = tab_id
-        batch_update_data = {
-            "requests": [
-                {
-                    "insertTable": {
-                        "location": location,
-                        "rows": rows,
-                        "columns": columns,
-                    }
-                }
-            ]
-        }
+        batch_update_data = {"requests": [{"insertTable": {"location": location, "rows": rows, "columns": columns}}]}
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def create_footer(
+    async def create_footer(
         self,
         document_id: str,
         footer_type: str = "DEFAULT",
@@ -517,21 +466,21 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Creates a footer of a specified type in a Google Document using the batch update API. This function, distinct from `create_header`, can optionally associate the new footer with a specific section break, enabling section-specific footers within the document.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to update.
             footer_type: The type of footer to create, such as 'DEFAULT' or 'HEADER_FOOTER_TYPE_UNSPECIFIED'.
             section_break_location_index: Optional index of the SectionBreak location to associate with the footer.
             section_break_segment_id: Optional segment ID of the SectionBreak location.
             section_break_tab_id: Optional tab ID of the SectionBreak location.
-        
+
         Returns:
             A dictionary containing the Google Docs API response from the create footer operation.
-        
+
         Raises:
             HTTPError: Raised when the API request fails due to reasons like invalid document_id or insufficient permissions.
             RequestException: Raised when there are network connectivity issues or problems with the API endpoint.
-        
+
         Tags:
             footer, create, document, api, google-docs, batch, content-management, important
         """
@@ -539,19 +488,16 @@ class GoogleDocsApp(APIApplication):
         create_footer_request = {"type": footer_type}
         if section_break_location_index is not None:
             section_break_location = {"index": section_break_location_index}
-
             if section_break_segment_id is not None:
                 section_break_location["segmentId"] = section_break_segment_id
-
             if section_break_tab_id is not None:
                 section_break_location["tabId"] = section_break_tab_id
-
             create_footer_request["sectionBreakLocation"] = section_break_location
         batch_update_data = {"requests": [{"createFooter": create_footer_request}]}
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def create_footnote(
+    async def create_footnote(
         self,
         document_id: str,
         location_index: int = None,
@@ -563,7 +509,7 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Inserts a numbered footnote reference into a Google Document using the batchUpdate API. The footnote can be placed at a precise index or at the end of a document segment, distinct from the `create_footer` function which adds standard page footers.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             location_index: The zero-based index within the document where the footnote reference will be inserted (optional if inserting at end of segment).
@@ -572,68 +518,53 @@ class GoogleDocsApp(APIApplication):
             end_of_segment_location: If True, inserts the footnote reference at the end of a segment instead of a specific index (default is False).
             end_of_segment_segment_id: The segment ID indicating where to insert the footnote at the end of a segment (optional).
             end_of_segment_tab_id: The tab ID for the end-of-segment location (optional).
-        
+
         Returns:
             A dictionary containing the response from the Google Docs API after performing the footnote creation operation.
-        
+
         Raises:
             HTTPError: Raised when the API request fails, such as due to an invalid document ID or insufficient permissions.
             RequestException: Raised when there are network connectivity issues or problems reaching the API endpoint.
-        
+
         Tags:
             footnote, create, document, api, google-docs, batch, content-management, important
         """
         url = f"{self.base_api_url}/{document_id}:batchUpdate"
         create_footnote_request = {}
         if end_of_segment_location:
-            # Use endOfSegmentLocation
             end_of_segment_location_obj = {}
-
             if end_of_segment_segment_id is not None:
                 end_of_segment_location_obj["segmentId"] = end_of_segment_segment_id
-
             if end_of_segment_tab_id is not None:
                 end_of_segment_location_obj["tabId"] = end_of_segment_tab_id
-
-            create_footnote_request["endOfSegmentLocation"] = (
-                end_of_segment_location_obj
-            )
+            create_footnote_request["endOfSegmentLocation"] = end_of_segment_location_obj
         else:
-            # Use specific location
             location = {"index": location_index}
-
             if location_segment_id is not None:
                 location["segmentId"] = location_segment_id
-
             if location_tab_id is not None:
                 location["tabId"] = location_tab_id
-
             create_footnote_request["location"] = location
         batch_update_data = {"requests": [{"createFootnote": create_footnote_request}]}
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def delete_footer(
-        self,
-        document_id: str,
-        footer_id: str,
-        tab_id: str = None,
-    ) -> dict[str, Any]:
+    async def delete_footer(self, document_id: str, footer_id: str, tab_id: str = None) -> dict[str, Any]:
         """
         Deletes a specific footer from a Google Document using its unique ID via a batchUpdate API request. This operation removes the entire footer object, optionally within a specific tab, distinguishing it from functions that delete headers (`delete_header`) or general content (`delete_content_range`).
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             footer_id: The identifier of the footer to delete.
             tab_id: Optional identifier of the tab containing the footer to delete.
-        
+
         Returns:
             A dictionary containing the response from the Google Docs API after performing the delete footer operation.
-        
+
         Raises:
             HTTPError: Raised when the API request fails due to reasons such as an invalid document ID or insufficient permissions.
             RequestException: Raised for network-related issues or problems reaching the API endpoint.
-        
+
         Tags:
             footer, delete, remove, document, api, google-docs, batch, content-management, important
         """
@@ -645,7 +576,7 @@ class GoogleDocsApp(APIApplication):
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def create_header(
+    async def create_header(
         self,
         document_id: str,
         header_type: str = "DEFAULT",
@@ -655,21 +586,21 @@ class GoogleDocsApp(APIApplication):
     ) -> dict[str, Any]:
         """
         Creates a header of a specified type in a Google Document using the batchUpdate API. This function can optionally associate the new header with a specific section break, distinguishing it from the `create_footer` method, which performs the equivalent action for footers.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             header_type: The type of header to create, e.g., 'DEFAULT' or 'HEADER_FOOTER_TYPE_UNSPECIFIED'.
             section_break_location_index: The index position of the section break location within the document, if applicable.
             section_break_segment_id: The segment ID associated with the section break location, if applicable.
             section_break_tab_id: The tab ID associated with the section break location, if applicable.
-        
+
         Returns:
             A dictionary containing the response from the Google Docs API after the header creation request.
-        
+
         Raises:
             HTTPError: If the API request fails due to issues such as an invalid document ID or insufficient permissions.
             RequestException: If there are network problems or issues reaching the API endpoint.
-        
+
         Tags:
             header, create, document, api, google-docs, batch, content-management, important
         """
@@ -677,39 +608,31 @@ class GoogleDocsApp(APIApplication):
         create_header_request = {"type": header_type}
         if section_break_location_index is not None:
             section_break_location = {"index": section_break_location_index}
-
             if section_break_segment_id is not None:
                 section_break_location["segmentId"] = section_break_segment_id
-
             if section_break_tab_id is not None:
                 section_break_location["tabId"] = section_break_tab_id
-
             create_header_request["sectionBreakLocation"] = section_break_location
         batch_update_data = {"requests": [{"createHeader": create_header_request}]}
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def delete_header(
-        self,
-        document_id: str,
-        header_id: str,
-        tab_id: str = None,
-    ) -> dict[str, Any]:
+    async def delete_header(self, document_id: str, header_id: str, tab_id: str = None) -> dict[str, Any]:
         """
         Deletes a specific header from a Google Document using its unique ID via a batchUpdate API request. This function, the counterpart to `create_header`, removes headers and can optionally target a header within a specific tab. It requires both the document and header IDs for the operation.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             header_id: The ID of the header to delete.
             tab_id: Optional ID of the tab containing the header to delete.
-        
+
         Returns:
             A dictionary containing the response from the Google Docs API after performing the delete header operation.
-        
+
         Raises:
             HTTPError: Raised when the API request fails due to invalid document_id, insufficient permissions, or other HTTP errors.
             RequestException: Raised when network connectivity issues or API endpoint problems occur during the request.
-        
+
         Tags:
             header, delete, remove, document, api, google-docs, batch, content-management, important
         """
@@ -721,18 +644,12 @@ class GoogleDocsApp(APIApplication):
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def apply_list_style(
-        self,
-        document_id: str,
-        start_index: int,
-        end_index: int,
-        bullet_preset: str,
-        segment_id: str = None,
-        tab_id: str = None,
+    async def apply_list_style(
+        self, document_id: str, start_index: int, end_index: int, bullet_preset: str, segment_id: str = None, tab_id: str = None
     ) -> dict[str, Any]:
         """
         Applies a predefined list style (bulleted or numbered) to paragraphs within a specified range using a chosen preset. Unlike `delete_paragraph_bullets`, which removes list formatting, this function creates it, distinguishing it from other text and paragraph styling methods in the class.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             start_index: The zero-based start index of the text range to which the list style should be applied.
@@ -740,14 +657,14 @@ class GoogleDocsApp(APIApplication):
             bullet_preset: Specifies the bullet or numbering style preset to use (e.g., bulleted or numbered formats with specific glyphs).
             segment_id: Optional segment ID within the document where the updates apply.
             tab_id: Optional tab ID within the segment to narrow the update scope.
-        
+
         Returns:
             A dictionary representing the Google Docs API response confirming the application of the bullet list style.
-        
+
         Raises:
             HTTPError: Raised when the API request to update the document fails (e.g., invalid document ID or insufficient permissions).
             RequestException: Raised on network issues or problems reaching the API endpoint.
-        
+
         Tags:
             bullets, list, paragraph, document, api, google-docs, batch, content-management, important
         """
@@ -757,44 +674,30 @@ class GoogleDocsApp(APIApplication):
             range_obj["segmentId"] = segment_id
         if tab_id is not None:
             range_obj["tabId"] = tab_id
-        batch_update_data = {
-            "requests": [
-                {
-                    "createParagraphBullets": {
-                        "range": range_obj,
-                        "bulletPreset": bullet_preset,
-                    }
-                }
-            ]
-        }
+        batch_update_data = {"requests": [{"createParagraphBullets": {"range": range_obj, "bulletPreset": bullet_preset}}]}
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
-    def delete_paragraph_bullets(
-        self,
-        document_id: str,
-        start_index: int,
-        end_index: int,
-        segment_id: str = None,
-        tab_id: str = None,
+    async def delete_paragraph_bullets(
+        self, document_id: str, start_index: int, end_index: int, segment_id: str = None, tab_id: str = None
     ) -> dict[str, Any]:
         """
         Removes bullet points or numbering from paragraphs within a specified index range in a Google Document. This reverts list formatting to normal text while preserving content, acting as the inverse operation to the `apply_list_style` function.
-        
+
         Args:
             document_id: The unique identifier of the Google Document to be updated.
             start_index: The zero-based start index of the range to remove bullets from.
             end_index: The zero-based end index of the range to remove bullets from (exclusive).
             segment_id: Optional segment ID specifying a subset of the document where the range applies.
             tab_id: Optional tab ID specifying a particular tab within the document where the range applies.
-        
+
         Returns:
             A dictionary containing the Google Docs API response after performing the delete bullets operation.
-        
+
         Raises:
             HTTPError: Raised when the API request fails due to invalid document ID, insufficient permissions, or other server-side errors.
             RequestException: Raised when there are network connectivity issues or problems accessing the API endpoint.
-        
+
         Tags:
             bullets, delete, remove, list, paragraph, document, api, google-docs, batch, content-management
         """
@@ -804,16 +707,13 @@ class GoogleDocsApp(APIApplication):
             range_obj["segmentId"] = segment_id
         if tab_id is not None:
             range_obj["tabId"] = tab_id
-        batch_update_data = {
-            "requests": [{"deleteParagraphBullets": {"range": range_obj}}]
-        }
+        batch_update_data = {"requests": [{"deleteParagraphBullets": {"range": range_obj}}]}
         response = self._post(url, data=batch_update_data)
         return self._handle_response(response)
 
     def list_tools(self):
         return [
             self.create_document,
-            # self.get_document,
             self.get_document_content,
             self.insert_text,
             self.apply_text_style,