alita-sdk 0.3.185__tar.gz → 0.3.186__tar.gz

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: alita_sdk
-Version: 0.3.185
+Version: 0.3.186
 Summary: SDK for building langchain agents using resources from Alita
 Author-email: Artem Rozumenko <artyom.rozumenko@gmail.com>, Mikalai Biazruchka <mikalai_biazruchka@epam.com>, Roman Mitusov <roman_mitusov@epam.com>, Ivan Krakhmaliuk <lifedjik@gmail.com>, Artem Dubrovskiy <ad13box@gmail.com>
 License-Expression: Apache-2.0

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/ado/repos/__init__.py

@@ -46,19 +46,19 @@ class AzureDevOpsReposToolkit(BaseToolkit):
         AzureDevOpsReposToolkit.toolkit_max_length = get_max_toolkit_length(selected_tools)
         m = create_model(
             name,
-            organization_url=(Optional[str], Field(default="", title="Organization URL",
+            organization_url=(str, Field(title="Organization URL",
                                                    description="ADO organization url",
                                                    json_schema_extra={
                                                        'configuration': True,
                                                        "configuration_title": True
                                                    })),
-            project=(Optional[str], Field(default="", title="Project", description="ADO project", json_schema_extra={'configuration': True})),
-            repository_id=(Optional[str], Field(default="", title="Repository ID", description="ADO repository ID",
+            project=(str, Field(title="Project", description="ADO project", json_schema_extra={'configuration': True})),
+            repository_id=(str, Field(title="Repository ID", description="ADO repository ID",
                                                 json_schema_extra={
                                                     'toolkit_name': True,
                                                     'max_toolkit_length': AzureDevOpsReposToolkit.toolkit_max_length,
                                                     'configuration': True})),
-            token=(Optional[SecretStr], Field(default="", title="Token", description="ADO token", json_schema_extra={'secret': True, 'configuration': True})),
+            token=(SecretStr, Field(title="Token", description="ADO token", json_schema_extra={'secret': True, 'configuration': True})),
             base_branch=(Optional[str], Field(default="", title="Base branch", description="ADO base branch (e.g., main)")),
             active_branch=(Optional[str], Field(default="", title="Active branch", description="ADO active branch (e.g., main)")),
 
@@ -84,7 +84,8 @@ class AzureDevOpsReposToolkit(BaseToolkit):
                         }
                     },
                     "categories": ["code repositories"],
-                    "extra_categories": ["code", "repository", "version control"]
+                    "extra_categories": ["code", "repository", "version control"],
+                    "configuration_group": "ado-repos",
                 }}}
         )
 

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/ado/test_plan/__init__.py

@@ -24,12 +24,13 @@ class AzureDevOpsPlansToolkit(BaseToolkit):
         m = create_model(
             name_alias,
             name=(str, Field(description="Toolkit name", json_schema_extra={'toolkit_name': True, 'max_toolkit_length': AzureDevOpsPlansToolkit.toolkit_max_length})),
-            organization_url=(str, Field(default="", title="Organization URL",
+            organization_url=(str, Field(title="Organization URL",
                                                    description="ADO organization url",
                                                    json_schema_extra={
                                                        'configuration': True,
-                                                       "configuration_title": True
+                                                       'configuration_title': True
                                                    })),
+            project=(str, Field(title="Project", description="ADO project", json_schema_extra={'configuration': True})),
             limit=(Optional[int], Field(description="ADO plans limit used for limitation of the list with results", default=5)),
             token=(SecretStr, Field(description="ADO token", json_schema_extra={'secret': True, 'configuration': True})),
             selected_tools=(List[Literal[tuple(selected_tools)]], Field(default=[], json_schema_extra={'args_schemas': selected_tools})),
@@ -49,7 +50,8 @@ class AzureDevOpsPlansToolkit(BaseToolkit):
                                 }
                             ]
                         }
-                    }
+                    },
+                    "configuration_group": "ado",
                 }
             }
             }

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/ado/test_plan/test_plan_wrapper.py

@@ -20,19 +20,16 @@ logger = logging.getLogger(__name__)
 # Input models for Test Plan operations
 TestPlanCreateModel = create_model(
     "TestPlanCreateModel",
-    test_plan_create_params=(str, Field(description="JSON of the test plan create parameters")),
-    project=(str, Field(description="Project ID or project name"))
+    test_plan_create_params=(str, Field(description="JSON of the test plan create parameters"))
 )
 
 TestPlanDeleteModel = create_model(
     "TestPlanDeleteModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan to be deleted"))
 )
 
 TestPlanGetModel = create_model(
     "TestPlanGetModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(Optional[int], Field(description="ID of the test plan to get", default=None))
 )
 
@@ -77,20 +74,17 @@ TestSuiteCreateModel = create_model(
         'name':'str'
     }
     """)),
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan that contains the suites"))
 )
 
 TestSuiteDeleteModel = create_model(
     "TestSuiteDeleteModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan that contains the suite")),
     suite_id=(int, Field(description="ID of the test suite to delete"))
 )
 
 TestSuiteGetModel = create_model(
     "TestSuiteGetModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan that contains the suites")),
     suite_id=(Optional[int], Field(description="ID of the suite to get", default=None))
 )
@@ -98,14 +92,12 @@ TestSuiteGetModel = create_model(
 TestCaseAddModel = create_model(
     "TestCaseAddModel",
     suite_test_case_create_update_parameters=(str, Field(description='JSON array of the suite test case create update parameters. Example: \"[{"work_item":{"id":"23"}}]\"')),
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan to which test cases are to be added")),
     suite_id=(int, Field(description="ID of the test suite to which test cases are to be added"))
 )
 
 TestCaseCreateModel = create_model(
     "TestCaseCreateModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan to which test cases are to be added")),
     suite_id=(int, Field(description="ID of the test suite to which test cases are to be added")),
     title=(str, Field(description="Test case title")),
@@ -115,7 +107,6 @@ TestCaseCreateModel = create_model(
 
 TestCaseGetModel = create_model(
     "TestCaseGetModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan for which test cases are requested")),
     suite_id=(int, Field(description="ID of the test suite for which test cases are requested")),
     test_case_id=(str, Field(description="Test Case Id to be fetched"))
@@ -123,7 +114,6 @@ TestCaseGetModel = create_model(
 
 TestCasesGetModel = create_model(
     "TestCasesGetModel",
-    project=(str, Field(description="Project ID or project name")),
     plan_id=(int, Field(description="ID of the test plan for which test cases are requested")),
     suite_id=(int, Field(description="ID of the test suite for which test cases are requested"))
 )
@@ -131,6 +121,7 @@ TestCasesGetModel = create_model(
 class TestPlanApiWrapper(BaseToolApiWrapper):
     __test__ = False
     organization_url: str
+    project: str
     token: SecretStr
     limit: Optional[int] = 5
     _client: Optional[TestPlanClient] = PrivateAttr()
@@ -148,90 +139,90 @@ class TestPlanApiWrapper(BaseToolApiWrapper):
             raise ImportError(f"Failed to connect to Azure DevOps: {e}")
         return values
 
-    def create_test_plan(self, test_plan_create_params: str, project: str):
+    def create_test_plan(self, test_plan_create_params: str):
         """Create a test plan in Azure DevOps."""
         try:
             params = json.loads(test_plan_create_params)
             test_plan_create_params_obj = TestPlanCreateParams(**params)
-            test_plan = self._client.create_test_plan(test_plan_create_params_obj, project)
+            test_plan = self._client.create_test_plan(test_plan_create_params_obj, self.project)
             return f"Test plan {test_plan.id} created successfully."
         except Exception as e:
             logger.error(f"Error creating test plan: {e}")
             return ToolException(f"Error creating test plan: {e}")
 
-    def delete_test_plan(self, project: str, plan_id: int):
+    def delete_test_plan(self, plan_id: int):
         """Delete a test plan in Azure DevOps."""
         try:
-            self._client.delete_test_plan(project, plan_id)
+            self._client.delete_test_plan(self.project, plan_id)
             return f"Test plan {plan_id} deleted successfully."
         except Exception as e:
             logger.error(f"Error deleting test plan: {e}")
             return ToolException(f"Error deleting test plan: {e}")
 
-    def get_test_plan(self, project: str, plan_id: Optional[int] = None):
+    def get_test_plan(self, plan_id: Optional[int] = None):
         """Get a test plan or list of test plans in Azure DevOps."""
         try:
             if plan_id:
-                test_plan = self._client.get_test_plan_by_id(project, plan_id)
+                test_plan = self._client.get_test_plan_by_id(self.project, plan_id)
                 return test_plan.as_dict()
             else:
-                test_plans = self._client.get_test_plans(project)
+                test_plans = self._client.get_test_plans(self.project)
                 return [plan.as_dict() for plan in test_plans]
         except Exception as e:
             logger.error(f"Error getting test plan(s): {e}")
             return ToolException(f"Error getting test plan(s): {e}")
 
-    def create_test_suite(self, test_suite_create_params: str, project: str, plan_id: int):
+    def create_test_suite(self, test_suite_create_params: str, plan_id: int):
         """Create a test suite in Azure DevOps."""
         try:
             params = json.loads(test_suite_create_params)
             test_suite_create_params_obj = TestSuiteCreateParams(**params)
-            test_suite = self._client.create_test_suite(test_suite_create_params_obj, project, plan_id)
+            test_suite = self._client.create_test_suite(test_suite_create_params_obj, self.project, plan_id)
             return f"Test suite {test_suite.id} created successfully."
         except Exception as e:
             logger.error(f"Error creating test suite: {e}")
             return ToolException(f"Error creating test suite: {e}")
 
-    def delete_test_suite(self, project: str, plan_id: int, suite_id: int):
+    def delete_test_suite(self, plan_id: int, suite_id: int):
         """Delete a test suite in Azure DevOps."""
         try:
-            self._client.delete_test_suite(project, plan_id, suite_id)
+            self._client.delete_test_suite(self.project, plan_id, suite_id)
             return f"Test suite {suite_id} deleted successfully."
         except Exception as e:
             logger.error(f"Error deleting test suite: {e}")
             return ToolException(f"Error deleting test suite: {e}")
 
-    def get_test_suite(self, project: str, plan_id: int, suite_id: Optional[int] = None):
+    def get_test_suite(self, plan_id: int, suite_id: Optional[int] = None):
         """Get a test suite or list of test suites in Azure DevOps."""
         try:
             if suite_id:
-                test_suite = self._client.get_test_suite_by_id(project, plan_id, suite_id)
+                test_suite = self._client.get_test_suite_by_id(self.project, plan_id, suite_id)
                 return test_suite.as_dict()
             else:
-                test_suites = self._client.get_test_suites_for_plan(project, plan_id)
+                test_suites = self._client.get_test_suites_for_plan(self.project, plan_id)
                 return [suite.as_dict() for suite in test_suites]
         except Exception as e:
             logger.error(f"Error getting test suite(s): {e}")
             return ToolException(f"Error getting test suite(s): {e}")
 
-    def add_test_case(self, suite_test_case_create_update_parameters, project: str, plan_id: int, suite_id: int):
+    def add_test_case(self, suite_test_case_create_update_parameters, plan_id: int, suite_id: int):
         """Add a test case to a suite in Azure DevOps."""
         try:
             if isinstance(suite_test_case_create_update_parameters, str):
                 suite_test_case_create_update_parameters = json.loads(suite_test_case_create_update_parameters)
             suite_test_case_create_update_params_obj = [SuiteTestCaseCreateUpdateParameters(**param) for param in suite_test_case_create_update_parameters]
-            test_cases = self._client.add_test_cases_to_suite(suite_test_case_create_update_params_obj, project, plan_id, suite_id)
+            test_cases = self._client.add_test_cases_to_suite(suite_test_case_create_update_params_obj, self.project, plan_id, suite_id)
             return [test_case.as_dict() for test_case in test_cases]
         except Exception as e:
             logger.error(f"Error adding test case: {e}")
             return ToolException(f"Error adding test case: {e}")
 
-    def create_test_case(self, project: str, plan_id: int, suite_id: int, title: str, description: str, test_steps: str):
+    def create_test_case(self, plan_id: int, suite_id: int, title: str, description: str, test_steps: str):
         """Creates a new test case in specified suite in Azure DevOps."""
-        work_item_wrapper = AzureDevOpsApiWrapper(organization_url=self.organization_url, token=self.token.get_secret_value(), project=project)
+        work_item_wrapper = AzureDevOpsApiWrapper(organization_url=self.organization_url, token=self.token.get_secret_value(), project=self.project)
         work_item_json = self.build_ado_test_case(title, description, json.loads(test_steps))
         created_work_item_id = work_item_wrapper.create_work_item(work_item_json=json.dumps(work_item_json), wi_type="Test Case")['id']
-        return self.add_test_case([{"work_item":{"id":created_work_item_id}}], project, plan_id, suite_id)
+        return self.add_test_case([{"work_item":{"id":created_work_item_id}}], plan_id, suite_id)
 
     def build_ado_test_case(self, title, description, steps):
         """
@@ -259,23 +250,23 @@ class TestPlanApiWrapper(BaseToolApiWrapper):
             }
         }
 
-    def get_test_case(self, project: str, plan_id: int, suite_id: int, test_case_id: str):
+    def get_test_case(self, plan_id: int, suite_id: int, test_case_id: str):
         """Get a test case from a suite in Azure DevOps."""
         try:
-            test_cases = self._client.get_test_case(project, plan_id, suite_id, test_case_id)
+            test_cases = self._client.get_test_case(self.project, plan_id, suite_id, test_case_id)
             if test_cases:  # This checks if the list is not empty
                 test_case = test_cases[0]
                 return test_case.as_dict()
             else:
-                return f"No test cases found per given criteria: project {project}, plan {plan_id}, suite {suite_id}, test case id {test_case_id}"
+                return f"No test cases found per given criteria: project {self.project}, plan {plan_id}, suite {suite_id}, test case id {test_case_id}"
         except Exception as e:
             logger.error(f"Error getting test case: {e}")
             return ToolException(f"Error getting test case: {e}")
 
-    def get_test_cases(self, project: str, plan_id: int, suite_id: int):
+    def get_test_cases(self, plan_id: int, suite_id: int):
         """Get test cases from a suite in Azure DevOps."""
         try:
-            test_cases = self._client.get_test_case_list(project, plan_id, suite_id)
+            test_cases = self._client.get_test_case_list(self.project, plan_id, suite_id)
             return [test_case.as_dict() for test_case in test_cases]
         except Exception as e:
             logger.error(f"Error getting test cases: {e}")

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/ado/wiki/__init__.py

@@ -25,7 +25,7 @@ class AzureDevOpsWikiToolkit(BaseToolkit):
                                  'toolkit_name': True,
                                  'max_toolkit_length': AzureDevOpsWikiToolkit.toolkit_max_length})
                   ),
-            organization_url=(str, Field(default="", title="Organization URL",
+            organization_url=(str, Field(title="Organization URL",
                                                    description="ADO organization url",
                                                    json_schema_extra={
                                                        'configuration': True,
@@ -52,7 +52,8 @@ class AzureDevOpsWikiToolkit(BaseToolkit):
                                     }
                                 ]
                             }
-                        }
+                        },
+                        "configuration_group": "ado",
                     }
                 }
             }

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/ado/work_item/__init__.py

@@ -24,7 +24,7 @@ class AzureDevOpsWorkItemsToolkit(BaseToolkit):
                                  'toolkit_name': True,
                                  'max_toolkit_length': AzureDevOpsWorkItemsToolkit.toolkit_max_length})
                   ),
-            organization_url=(str, Field(default="", title="Organization URL",
+            organization_url=(str, Field(title="Organization URL",
                                                    description="ADO organization url",
                                                    json_schema_extra={
                                                        'configuration': True,
@@ -51,7 +51,8 @@ class AzureDevOpsWorkItemsToolkit(BaseToolkit):
                                     }
                                 ]
                             }
-                        }
+                        },
+                        "configuration_group": "ado",
                     }
                 }
             }

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/bitbucket/api_wrapper.py

@@ -149,6 +149,69 @@ class BitbucketAPIWrapper(BaseCodeToolApiWrapper):
             return result if isinstance(result, ToolException) else f"File has been updated: {file_path}."
         except Exception as e:
             return ToolException(f"File was not updated due to error: {str(e)}")
+    
+    def get_pull_requests_commits(self, pr_id: str) -> List[Dict[str, Any]]:
+        """
+        Get commits from a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            List[Dict[str, Any]]: List of commits in the pull request
+        """
+        try:
+            result = self._bitbucket.get_pull_request_commits(pr_id=pr_id)
+            return result
+        except Exception as e:
+            return ToolException(f"Can't get commits from pull request `{pr_id}` due to error:\n{str(e)}")
+        
+    def get_pull_requests(self) -> List[Dict[str, Any]]:
+        """
+        Get pull requests from the repository
+        Returns:
+            List[Dict[str, Any]]: List of pull requests in the repository
+        """
+        return self._bitbucket.get_pull_requests()
+    
+    def get_pull_request(self, pr_id: str) -> Any:
+        """
+        Get details of a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            Any: Details of the pull request
+        """
+        try:
+            return self._bitbucket.get_pull_request(pr_id=pr_id)
+        except Exception as e:
+            return ToolException(f"Can't get pull request `{pr_id}` due to error:\n{str(e)}")
+        
+    def get_pull_requests_changes(self, pr_id: str) -> Any:
+        """
+        Get changes of a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            Any: Changes of the pull request
+        """
+        try:
+            return self._bitbucket.get_pull_requests_changes(pr_id=pr_id)
+        except Exception as e:
+            return ToolException(f"Can't get changes from pull request `{pr_id}` due to error:\n{str(e)}")
+        
+    def add_pull_request_comment(self, pr_id: str, content, inline=None) -> str:
+        """
+        Add a comment to a pull request. Supports multiple content types and inline comments.
+        Parameters:
+            pr_id (str): the pull request ID
+            content (str or dict): The comment content. Can be a string (raw text) or a dict with keys 'raw', 'markup', 'html'.
+            inline (dict, optional): Inline comment details. Example: {"from": 57, "to": 122, "path": "<string>"}
+        Returns:
+            str: A success or failure message
+        """
+        try:
+            return self._bitbucket.add_pull_request_comment(pr_id=pr_id, content=content, inline=inline)
+        except Exception as e:
+            return ToolException(f"Can't add comment to pull request `{pr_id}` due to error:\n{str(e)}")
 
     def _get_files(self, file_path: str, branch: str) -> str:
         """

{alita_sdk-0.3.185 → alita_sdk-0.3.186}/alita_sdk/tools/bitbucket/cloud_api_wrapper.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import json
 import logging
 from abc import ABC, abstractmethod
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, Dict, List
 
 from atlassian.bitbucket import Bitbucket, Cloud
 from langchain_core.tools import ToolException
@@ -43,6 +43,22 @@ class BitbucketApiAbstract(ABC):
     def create_file(self, file_path: str, file_contents: str, branch: str) -> str:
         pass
 
+    @abstractmethod
+    def get_pull_request_commits(self, pr_id: str) -> List[Dict[str, Any]]:
+        pass
+
+    @abstractmethod
+    def get_pull_request(self, pr_id: str) -> Any:
+        pass
+
+    @abstractmethod
+    def get_pull_requests_changes(self, pr_id: str) -> Any:
+        pass
+
+    @abstractmethod
+    def add_pull_request_comment(self, pr_id: str, text: str) -> str:
+        pass
+
 
 class BitbucketServerApi(BitbucketApiAbstract):
     api_client: Bitbucket
@@ -122,6 +138,71 @@ class BitbucketServerApi(BitbucketApiAbstract):
             filename=file_path,
             source_commit_id=source_commit['id']
         )
+    
+    def get_pull_request_commits(self, pr_id: str) -> List[Dict[str, Any]]:
+        """
+        Get commits from a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            List[Dict[str, Any]]: List of commits in the pull request
+        """
+        return self.api_client.get_pull_requests_commits(project_key=self.project, repository_slug=self.repository, pull_request_id=pr_id)
+    
+    def get_pull_request(self, pr_id):
+        """ Get details of a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            Any: Details of the pull request
+        """
+        return self.api_client.get_pull_request(project_key=self.project, repository_slug=self.repository, pull_request_id=pr_id)
+    
+    def get_pull_requests_changes(self, pr_id: str) -> Any:
+        """
+        Get changes of a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            Any: Changes of the pull request
+        """
+        return self.api_client.get_pull_requests_changes(project_key=self.project, repository_slug=self.repository, pull_request_id=pr_id)
+    
+    def add_pull_request_comment(self, pr_id, content, inline=None):
+        """
+        Add a comment to a pull request. Supports multiple content types and inline comments.
+        Parameters:
+            pr_id (str): the pull request ID
+            content (dict or str): The comment content. If str, will be used as raw text. If dict, can include 'raw', 'markup', 'html'.
+            inline (dict, optional): Inline comment details. Example: {"from": 57, "to": 122, "path": "<string>"}
+        Returns:
+            str: The API response or created comment URL
+        """
+        # Build the comment data
+        if isinstance(content, str):
+            comment_data = {"text": content}
+        elif isinstance(content, dict):
+            # Bitbucket Server API expects 'text' (raw), and optionally 'markup' and 'html' in a 'content' field
+            if 'raw' in content or 'markup' in content or 'html' in content:
+                comment_data = {"text": content.get("raw", "")}
+                if 'markup' in content:
+                    comment_data["markup"] = content["markup"]
+                if 'html' in content:
+                    comment_data["html"] = content["html"]
+            else:
+                comment_data = {"text": str(content)}
+        else:
+            comment_data = {"text": str(content)}
+
+        if inline:
+            comment_data["inline"] = inline
+
+        return self.api_client.add_pull_request_comment(
+            project_key=self.project,
+            repository_slug=self.repository,
+            pull_request_id=pr_id,
+            **comment_data
+        )
 
 class BitbucketCloudApi(BitbucketApiAbstract):
     api_client: Cloud
@@ -195,4 +276,64 @@ class BitbucketCloudApi(BitbucketApiAbstract):
                 "It may be helpful to use the read_file action to get "
                 "the current file contents."
             )
-        return self.create_file(file_path, updated_file_content, branch)
+        return self.create_file(file_path, updated_file_content, branch)
+    
+    def get_pull_request_commits(self, pr_id: str) -> List[Dict[str, Any]]:
+        """
+        Get commits from a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            List[Dict[str, Any]]: List of commits in the pull request
+        """
+        commits = self.repository.pullrequests.get(pr_id).get('commits', [])
+        if not isinstance(commits, list):
+            commits = list(commits)
+        return commits
+    
+    def get_pull_request(self, pr_id: str) -> Any:
+        """ Get details of a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            Any: Details of the pull request
+        """
+        return self.repository.pullrequests.get(pr_id)
+    
+    def get_pull_requests_changes(self, pr_id: str) -> Any:
+        """
+        Get changes of a pull request
+        Parameters:
+            pr_id(str): the pull request ID
+        Returns:
+            Any: Changes of the pull request
+        """
+        return self.repository.pullrequests.get(pr_id).get('diff', {})
+    
+    def add_pull_request_comment(self, pr_id: str, content, inline=None) -> str:
+        """
+        Add a comment to a pull request. Supports multiple content types and inline comments.
+        Parameters:
+            pr_id (str): the pull request ID
+            content (dict or str): The comment content. If str, will be used as raw text. If dict, can include 'raw', 'markup', 'html'.
+            inline (dict, optional): Inline comment details. Example: {"from": 57, "to": 122, "path": "<string>"}
+        Returns:
+            str: The URL of the created comment
+        """
+        # Build the content dict for Bitbucket Cloud
+        if isinstance(content, str):
+            content_dict = {"raw": content}
+        elif isinstance(content, dict):
+            # Only include allowed keys
+            content_dict = {k: v for k, v in content.items() if k in ("raw", "markup", "html")}
+            if not content_dict:
+                content_dict = {"raw": str(content)}
+        else:
+            content_dict = {"raw": str(content)}
+
+        data = {"content": content_dict}
+        if inline:
+            data["inline"] = inline
+
+        response = self.repository.pullrequests.comments.post(pr_id, data=data)
+        return response['links']['self']['href']