wandelbots-api-client 25.6.0.dev7__py3-none-any.whl → 25.10.0rc2__py3-none-any.whl

wandelbots_api_client/api/virtual_robot_setup_api.py

@@ -5,13 +5,12 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
 """  # noqa: E501
 
-
 from furl import furl
 import json
 import humps
@@ -68,7 +67,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Add Coordinate Systems
 
-        Adds a coordinate system to the robot controller. 
+        Adds a coordinate system to the robot controller.  > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -143,7 +142,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Add Coordinate Systems
 
-        Adds a coordinate system to the robot controller. 
+        Adds a coordinate system to the robot controller.  > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -218,7 +217,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Add Coordinate Systems
 
-        Adds a coordinate system to the robot controller. 
+        Adds a coordinate system to the robot controller.  > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -370,7 +369,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Add TCP
 
-        Adds a new TCP or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange’s coordinate system.  > **NOTE** > > Ensure the TCP's position is within the robot's reach. Refer to the robot’s documentation or data sheet for details like joint limits or reach. 
+        Adds a new [TCP](https://docs.wandelbots.io/latest/vocabulary#tcp) or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange's coordinate system.  > **NOTE** > Ensure the TCP's position is within the robot's reach. Refer to the robot's documentation or data sheet for details like joint limits or reach.  > **NOTE** > Upon adding or updating a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is available for use. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the TCP may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -449,7 +448,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Add TCP
 
-        Adds a new TCP or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange’s coordinate system.  > **NOTE** > > Ensure the TCP's position is within the robot's reach. Refer to the robot’s documentation or data sheet for details like joint limits or reach. 
+        Adds a new [TCP](https://docs.wandelbots.io/latest/vocabulary#tcp) or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange's coordinate system.  > **NOTE** > Ensure the TCP's position is within the robot's reach. Refer to the robot's documentation or data sheet for details like joint limits or reach.  > **NOTE** > Upon adding or updating a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is available for use. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the TCP may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -528,7 +527,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Add TCP
 
-        Adds a new TCP or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange’s coordinate system.  > **NOTE** > > Ensure the TCP's position is within the robot's reach. Refer to the robot’s documentation or data sheet for details like joint limits or reach. 
+        Adds a new [TCP](https://docs.wandelbots.io/latest/vocabulary#tcp) or updates an existing TCP in the motion group.  The position and rotation values in the request body are defined within the flange's coordinate system.  > **NOTE** > Ensure the TCP's position is within the robot's reach. Refer to the robot's documentation or data sheet for details like joint limits or reach.  > **NOTE** > Upon adding or updating a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is available for use. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the TCP may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -686,7 +685,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Remove Coordinate System
 
-        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and remove all dependent coordinate systems which use the deleted coordinate system as reference. 
+        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and also remove all dependent coordinate systems which use the deleted coordinate system as a reference.  **Important notes:** - When a new coordinate system is added/removed, the **virtual robot is restarted** in the background in order to apply the new configuration. - During this restart:   - Robot visualization may temporarily disappear or appear outdated in the UI.   - coordinate system changes are not immediately visible in visualizations.   - All existing connections to the virtual robot are closed and re-established, which introduces a short delay before the system is fully operational again. - The API call itself does **not wait until the restart and re-synchronization are complete**.   This means that immediately after a successful response, the new coordinate system may not yet be > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -765,7 +764,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Remove Coordinate System
 
-        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and remove all dependent coordinate systems which use the deleted coordinate system as reference. 
+        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and also remove all dependent coordinate systems which use the deleted coordinate system as a reference.  **Important notes:** - When a new coordinate system is added/removed, the **virtual robot is restarted** in the background in order to apply the new configuration. - During this restart:   - Robot visualization may temporarily disappear or appear outdated in the UI.   - coordinate system changes are not immediately visible in visualizations.   - All existing connections to the virtual robot are closed and re-established, which introduces a short delay before the system is fully operational again. - The API call itself does **not wait until the restart and re-synchronization are complete**.   This means that immediately after a successful response, the new coordinate system may not yet be > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -844,7 +843,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Remove Coordinate System
 
-        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and remove all dependent coordinate systems which use the deleted coordinate system as reference. 
+        Deletes a coordinate system from the virtual controller. This will remove the coordinate system from the list of coordinate systems and also remove all dependent coordinate systems which use the deleted coordinate system as a reference.  **Important notes:** - When a new coordinate system is added/removed, the **virtual robot is restarted** in the background in order to apply the new configuration. - During this restart:   - Robot visualization may temporarily disappear or appear outdated in the UI.   - coordinate system changes are not immediately visible in visualizations.   - All existing connections to the virtual robot are closed and re-established, which introduces a short delay before the system is fully operational again. - The API call itself does **not wait until the restart and re-synchronization are complete**.   This means that immediately after a successful response, the new coordinate system may not yet be > **NOTE** > > Upon adding or removing a coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or appear outdated in the UI. > - Coordinate system changes are not immediately visible in visualizations. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new coordinate system may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -991,7 +990,7 @@ class VirtualRobotSetupApi:
     ) -> object:
         """Remove TCP
 
-        Removes the TCP from the motion group. An unknown TCP is a valid input. 
+        Removes the TCP (Tool Center Point) from the motion group. An unknown TCP is a valid input and will simply be ignored.  > **NOTE** > Upon removing a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is removed. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that immediately after a successful response, the TCP may not be removed. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -1070,7 +1069,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[object]:
         """Remove TCP
 
-        Removes the TCP from the motion group. An unknown TCP is a valid input. 
+        Removes the TCP (Tool Center Point) from the motion group. An unknown TCP is a valid input and will simply be ignored.  > **NOTE** > Upon removing a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is removed. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that immediately after a successful response, the TCP may not be removed. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -1149,7 +1148,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Remove TCP
 
-        Removes the TCP from the motion group. An unknown TCP is a valid input. 
+        Removes the TCP (Tool Center Point) from the motion group. An unknown TCP is a valid input and will simply be ignored.  > **NOTE** > Upon removing a TCP, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear. > - TCP visualization may be delayed or outdated during the first run. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before the TCP is removed. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that immediately after a successful response, the TCP may not be removed. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -2143,7 +2142,7 @@ class VirtualRobotSetupApi:
     ) -> CoordinateSystem:
         """Set Mounting
 
-        Sets motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset. The transformation offset is defined by a unique identifier, a name for front end usage and an offset in another coordinate system referenced by the unique identifier of the reference coordinate system. 
+        Sets the motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset, which consists of: - A unique identifier - A name - An offset in another coordinate system, referenced by the unique identifier of the reference coordinate system.  > **NOTE** > Changing the mounting configuration is considered a configuration change. > > Upon updating the mounting to another coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or not reflect the updated mounting. > - Motion group state and coordinate system alignment may not be instantly updated. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new mounting may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -2222,7 +2221,7 @@ class VirtualRobotSetupApi:
     ) -> ApiResponse[CoordinateSystem]:
         """Set Mounting
 
-        Sets motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset. The transformation offset is defined by a unique identifier, a name for front end usage and an offset in another coordinate system referenced by the unique identifier of the reference coordinate system. 
+        Sets the motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset, which consists of: - A unique identifier - A name - An offset in another coordinate system, referenced by the unique identifier of the reference coordinate system.  > **NOTE** > Changing the mounting configuration is considered a configuration change. > > Upon updating the mounting to another coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or not reflect the updated mounting. > - Motion group state and coordinate system alignment may not be instantly updated. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new mounting may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str
@@ -2301,7 +2300,7 @@ class VirtualRobotSetupApi:
     ) -> RESTResponseType:
         """Set Mounting
 
-        Sets motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset. The transformation offset is defined by a unique identifier, a name for front end usage and an offset in another coordinate system referenced by the unique identifier of the reference coordinate system. 
+        Sets the motion group mounting by specifying a coordinate system. The motion group will be based on the coordinate system's origin. The coordinate system defines a transformation offset, which consists of: - A unique identifier - A name - An offset in another coordinate system, referenced by the unique identifier of the reference coordinate system.  > **NOTE** > Changing the mounting configuration is considered a configuration change. > > Upon updating the mounting to another coordinate system, virtual robots are restarted to apply the new configuration. > What happens during restart: > - Robot visualization may temporarily disappear or not reflect the updated mounting. > - Motion group state and coordinate system alignment may not be instantly updated. > - Existing connections to the virtual robot are closed and re-established, which introduces a short delay before NOVA is fully operational again. > > The API call itself **does not wait until the restart and synchronization are complete**. This means that > immediately after a successful response, the new mounting may not be available for visualization or program execution. 
 
         :param cell: Unique identifier addressing a cell in all API calls.  (required)
         :type cell: str

wandelbots_api_client/api_client.py

@@ -5,7 +5,7 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -21,6 +21,7 @@ import mimetypes
 import os
 import re
 import tempfile
+import uuid
 
 from urllib.parse import quote
 from typing import Tuple, Optional, List, Dict, Union
@@ -90,7 +91,7 @@ class ApiClient:
             self.default_headers[header_name] = header_value
         self.cookie = cookie
         # Set default User-Agent.
-        self.user_agent = 'Wandelbots-Nova-API-Python-Client/25.6.0.dev7'
+        self.user_agent = 'Wandelbots-Nova-API-Python-Client/25.10.0.rc2'
         self.client_side_validation = configuration.client_side_validation
 
     async def __aenter__(self):
@@ -359,6 +360,8 @@ class ApiClient:
             return obj.get_secret_value()
         elif isinstance(obj, self.PRIMITIVE_TYPES):
             return obj
+        elif isinstance(obj, uuid.UUID):
+            return str(obj)
         elif isinstance(obj, list):
             return [
                 self.sanitize_for_serialization(sub_obj) for sub_obj in obj
@@ -385,6 +388,10 @@ class ApiClient:
             else:
                 obj_dict = obj.__dict__
 
+        if isinstance(obj_dict, list):
+            # here we handle instances that can either be a list or something else, and only became a real list by calling to_dict()
+            return self.sanitize_for_serialization(obj_dict)
+
         return {
             key: self.sanitize_for_serialization(val)
             for key, val in obj_dict.items()
@@ -407,7 +414,7 @@ class ApiClient:
                 data = json.loads(response_text)
             except ValueError:
                 data = response_text
-        elif re.match(r'^application/(json|[\w!#$&.+-^_]+\+json)\s*(;|$)', content_type, re.IGNORECASE):
+        elif re.match(r'^application/(json|[\w!#$&.+\-^_]+\+json)\s*(;|$)', content_type, re.IGNORECASE):
             if response_text == "":
                 data = ""
             else:
@@ -456,13 +463,13 @@ class ApiClient:
 
         if klass in self.PRIMITIVE_TYPES:
             return self.__deserialize_primitive(data, klass)
-        elif klass == object:
+        elif klass is object:
             return self.__deserialize_object(data)
-        elif klass == datetime.date:
+        elif klass is datetime.date:
             return self.__deserialize_date(data)
-        elif klass == datetime.datetime:
+        elif klass is datetime.datetime:
             return self.__deserialize_datetime(data)
-        elif klass == decimal.Decimal:
+        elif klass is decimal.Decimal:
             return decimal.Decimal(data)
         elif issubclass(klass, Enum):
             return self.__deserialize_enum(data, klass)

wandelbots_api_client/authorization.py

@@ -0,0 +1,244 @@
+from typing import Optional
+
+import asyncio
+import aiohttp
+import pydantic
+
+class Auth0Config(pydantic.BaseModel):
+    """Configuration for Auth0 authentication"""
+
+    domain: Optional[str] = None
+    client_id: Optional[str] = None
+    audience: Optional[str] = None
+
+    @classmethod
+    def default(cls) -> "Auth0Config":
+        """Create Auth0Config from environment variables"""
+        return cls(
+            domain="auth.portal.wandelbots.io",
+            client_id="J7WJUi38xVQdJAEBNRT9Xw1b0fXDb4J2",
+            audience="nova-api",
+        )
+
+    def is_complete(self) -> bool:
+        """Check if all required fields are set and not None"""
+        return bool(self.domain and self.client_id and self.audience)
+
+    def get_validated_config(self) -> tuple[str, str, str]:
+        """Get validated config values, ensuring they are not None"""
+        if not self.is_complete():
+            raise ValueError("Auth0 configuration is incomplete")
+        return self.domain, self.client_id, self.audience
+
+
+class Auth0DeviceCodeInfo(pydantic.BaseModel):
+    """
+    Model to store device code information.
+
+    Attributes:
+        device_code (str): The device code.
+        user_code (str): The user code.
+        verification_uri (str): The verification URI.
+        expires_in (int): The expiration time in seconds.
+        interval (int): The interval time in seconds (default is 5).
+    """
+
+    device_code: str
+    user_code: str
+    verification_uri: str
+    expires_in: int
+    interval: int = pydantic.Field(default=5)
+
+
+class Auth0TokenInfo(pydantic.BaseModel):
+    """
+    Model to store token information.
+
+    Attributes:
+        access_token (str): The access token.
+        refresh_token (str, optional): The refresh token.
+    """
+
+    access_token: str
+    refresh_token: Optional[str] = None
+
+
+class Auth0DeviceAuthorization:
+    """
+    Class to handle Auth0 device authorization.
+
+    Methods:
+        __init__(auth0_config: Auth0Config | None = None):
+            Initializes the Auth0DeviceAuthorization instance with the given parameters.
+        request_device_code():
+            Requests a device code from Auth0.
+        display_user_instructions():
+            Displays instructions for the user to authenticate.
+        poll_token_endpoint():
+            Polls the token endpoint to obtain an access token.
+        refresh_access_token(refresh_token: str):
+            Refreshes the access token using the refresh token.
+    """
+
+    def __init__(self, auth0_config: Optional[Auth0Config] = None):
+        """
+        Initialize with Auth0Config from env vars or passed config.
+
+        Args:
+            auth0_config: Optional Auth0Config object. If not provided,
+                         will be created using default configuration.
+        """
+        try:
+            self.params = auth0_config or Auth0Config.default()
+            if not self.params.is_complete():
+                raise ValueError("Auth0 configuration is incomplete")
+
+            domain, client_id, audience = self.params.get_validated_config()
+            self.auth0_domain = domain
+            self.auth0_client_id = client_id
+            self.auth0_audience = audience
+
+        except ValueError as e:
+            raise ValueError(f"Error: Auth0 configuration is invalid: {e}")
+
+        self.headers = {"content-type": "application/x-www-form-urlencoded"}
+        self.device_code_info: Optional[Auth0DeviceCodeInfo] = None
+        self.refresh_token: Optional[str] = None
+        self.interval = 5
+        self.attempts = 10
+
+    async def request_device_code(self) -> Auth0DeviceCodeInfo:
+        """
+        Requests a device code from Auth0.
+
+        Returns:
+            Auth0DeviceCodeInfo: The device code information.
+
+        Raises:
+            Exception: If there is an error requesting the device code.
+        """
+        device_code_url = f"https://{self.auth0_domain}/oauth/device/code"
+        data = {
+            "client_id": self.auth0_client_id,
+            "scope": "openid profile email",
+            "audience": self.auth0_audience,
+        }
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(device_code_url, headers=self.headers, data=data) as response:
+                if response.status == 200:
+                    response_data = await response.json()
+                    self.device_code_info = Auth0DeviceCodeInfo(**response_data)
+                    self.interval = self.device_code_info.interval
+                    return self.device_code_info
+                else:
+                    error_data = await response.json()
+                    raise Exception("Error requesting device code:", error_data)
+
+    def get_device_code_info(self) -> Optional[Auth0DeviceCodeInfo]:
+        """
+        Returns the device code information.
+
+        Returns:
+            Optional[Auth0DeviceCodeInfo]: The device code information.
+        """
+        return self.device_code_info
+
+    def display_user_instructions(self) -> None:
+        """
+        Displays instructions for the user to authenticate.
+
+        Raises:
+            Exception: If device code information is not available.
+        """
+        if self.device_code_info:
+            verification_uri = f"{self.device_code_info.verification_uri}?user_code={self.device_code_info.user_code}"
+            user_code = self.device_code_info.user_code
+            print(
+                f"Please visit {verification_uri} and validate the code {user_code} to authenticate."
+            )
+        else:
+            raise Exception("Device code information is not available.")
+
+    async def poll_token_endpoint(self):
+        """
+        Polls the token endpoint to obtain an access token.
+
+        Returns:
+            str: The access token.
+
+        Raises:
+            Exception: If there is an error polling the token endpoint.
+        """
+        if not self.device_code_info:
+            raise Exception("Device code information is not available.")
+
+        token_url = f"https://{self.auth0_domain}/oauth/token"
+        token_data = {
+            "grant_type": "urn:ietf:params:oauth:grant-type:device_code",
+            "device_code": self.device_code_info.device_code,
+            "client_id": self.auth0_client_id,
+        }
+
+        async with aiohttp.ClientSession() as session:
+            while self.attempts > 0:
+                self.attempts = self.attempts - 1
+                async with session.post(token_url, headers=self.headers, data=token_data) as token_response:
+                    if token_response.status == 200:
+                        # If the response status is 200, it means the access token is successfully obtained.
+                        response_data = await token_response.json()
+                        token_info = Auth0TokenInfo(**response_data)
+                        self.refresh_token = token_info.refresh_token
+                        return token_info.access_token
+                    elif token_response.status == 400:
+                        # If the response status is 400, check the error type.
+                        error_data = await token_response.json()
+                        error = error_data.get("error")
+                        if error == "authorization_pending":
+                            # If the error is 'authorization_pending', it means the user has not yet authorized.
+                            await asyncio.sleep(self.interval)
+                        elif error == "slow_down":
+                            # If the error is 'slow_down', it means the server requests to slow down polling.
+                            self.interval += 5
+                            await asyncio.sleep(self.interval)
+                    elif token_response.status == 403:
+                        # If the response status is 403, it means the request is forbidden, wait and retry.
+                        await asyncio.sleep(self.interval)
+                    else:
+                        # For other status codes, raise an exception with the error details.
+                        error_data = await token_response.json()
+                        raise Exception("Error:", token_response.status, error_data)
+        raise Exception("Error: It was not able to authenticate. Please try again.")
+
+    async def refresh_access_token(self, refresh_token: str):
+        """
+        Refreshes the access token using the refresh token.
+
+        Args:
+            refresh_token (str): The refresh token.
+
+        Returns:
+            str: The new access token.
+
+        Raises:
+            Exception: If there is an error refreshing the access token.
+        """
+        if not refresh_token:
+            raise Exception("Refresh token is not available.")
+
+        token_url = f"https://{self.auth0_domain}/oauth/token"
+        token_data = {
+            "grant_type": "refresh_token",
+            "client_id": self.auth0_client_id,
+            "refresh_token": refresh_token,
+        }
+
+        async with aiohttp.ClientSession() as session:
+            async with session.post(token_url, headers=self.headers, data=token_data) as response:
+                if response.status == 200:
+                    response_data = await response.json()
+                    token_info = Auth0TokenInfo(**response_data)
+                    return token_info.access_token
+                else:
+                    error_data = await response.json()
+                    raise Exception("Error refreshing access token:", error_data)

wandelbots_api_client/configuration.py

@@ -5,7 +5,7 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -17,7 +17,7 @@ import http.client as httplib
 import logging
 from logging import FileHandler
 import sys
-from typing import Any, ClassVar, Dict, List, Literal, Optional, TypedDict
+from typing import Any, ClassVar, Dict, List, Literal, Optional, TypedDict, Union
 from typing_extensions import NotRequired, Self
 
 import urllib3
@@ -161,6 +161,10 @@ class Configuration:
     :param ssl_ca_cert: str - the path to a file of concatenated CA certificates
       in PEM format.
     :param retries: Number of retries for API requests.
+    :param ca_cert_data: verify the peer using concatenated CA certificate data
+      in PEM (str) or DER (bytes) format.
+    :param cert_file: the path to a client certificate file, for mTLS.
+    :param key_file: the path to a client key file, for mTLS. 
 
     :Example:
 
@@ -191,13 +195,16 @@ conf = wandelbots_api_client.Configuration(
         username: Optional[str]=None,
         password: Optional[str]=None,
         access_token: Optional[str]=None,
-        server_index: Optional[int]=None, 
+        server_index: Optional[int]=None,
         server_variables: Optional[ServerVariablesT]=None,
         server_operation_index: Optional[Dict[int, int]]=None,
         server_operation_variables: Optional[Dict[int, ServerVariablesT]]=None,
         ignore_operation_servers: bool=False,
         ssl_ca_cert: Optional[str]=None,
         retries: Optional[int] = None,
+        ca_cert_data: Optional[Union[str, bytes]] = None,
+        cert_file: Optional[str]=None,
+        key_file: Optional[str]=None,
         *,
         debug: Optional[bool] = None,
     ) -> None:
@@ -275,10 +282,14 @@ conf = wandelbots_api_client.Configuration(
         self.ssl_ca_cert = ssl_ca_cert
         """Set this to customize the certificate file to verify the peer.
         """
-        self.cert_file = None
+        self.ca_cert_data = ca_cert_data
+        """Set this to verify the peer using PEM (str) or DER (bytes)
+           certificate data.
+        """
+        self.cert_file = cert_file
         """client certificate file
         """
-        self.key_file = None
+        self.key_file = key_file
         """client key file
         """
         self.assert_hostname = None
@@ -523,8 +534,8 @@ conf = wandelbots_api_client.Configuration(
         return "Python SDK Debug Report:\n"\
                "OS: {env}\n"\
                "Python Version: {pyversion}\n"\
-               "Version of the API: 1.0.0 beta\n"\
-               "SDK Package Version: 25.6.0.dev7".\
+               "Version of the API: 1.1.0\n"\
+               "SDK Package Version: 25.10.0.rc2".\
                format(env=sys.platform, pyversion=sys.version)
 
     def get_host_settings(self) -> List[HostSetting]:

wandelbots_api_client/exceptions.py

@@ -5,7 +5,7 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.

wandelbots_api_client/models/__init__.py

@@ -6,13 +6,12 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
 """  # noqa: E501
 
-
 # import models into model package
 from .abb_controller import AbbController
 from .abb_controller_egm_server import AbbControllerEgmServer
@@ -20,6 +19,7 @@ from .activate_license_request import ActivateLicenseRequest
 from .add_request import AddRequest
 from .all_joint_positions_request import AllJointPositionsRequest
 from .all_joint_positions_response import AllJointPositionsResponse
+from .api_version import ApiVersion
 from .app import App
 from .array_input import ArrayInput
 from .array_output import ArrayOutput
@@ -72,7 +72,6 @@ from .create_program_run200_response import CreateProgramRun200Response
 from .create_program_run_request import CreateProgramRunRequest
 from .create_trigger200_response import CreateTrigger200Response
 from .create_trigger_request import CreateTriggerRequest
-from .create_trigger_request_config import CreateTriggerRequestConfig
 from .cubic_spline import CubicSpline
 from .cubic_spline_cubic_spline_parameter import CubicSplineCubicSplineParameter
 from .cubic_spline_parameter import CubicSplineParameter
@@ -313,6 +312,7 @@ __all__ = [
     "AddRequest", 
     "AllJointPositionsRequest", 
     "AllJointPositionsResponse", 
+    "ApiVersion", 
     "App", 
     "ArrayInput", 
     "ArrayOutput", 
@@ -365,7 +365,6 @@ __all__ = [
     "CreateProgramRunRequest", 
     "CreateTrigger200Response", 
     "CreateTriggerRequest", 
-    "CreateTriggerRequestConfig", 
     "CubicSpline", 
     "CubicSplineCubicSplineParameter", 
     "CubicSplineParameter", 

wandelbots_api_client/models/abb_controller.py

@@ -5,7 +5,7 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -27,10 +27,10 @@ class AbbController(BaseModel):
     """
     The configuration of a physical ABB robot controller has to contain IP address. Additionally an EGM server configuration has to be specified in order to control the robot. Deploying the server is a functionality of this API. 
     """ # noqa: E501
-    kind: Optional[StrictStr] = 'AbbController'
-    controller_ip: StrictStr = Field(alias="controllerIp")
-    controller_port: StrictInt = Field(description="Default values: 80, 443. If custom value is set, field is required. ", alias="controllerPort")
-    egm_server: AbbControllerEgmServer = Field(alias="egmServer")
+    kind: str = "AbbController"
+    controller_ip: StrictStr = Field(alias="controllerIp") 
+    controller_port: StrictInt = Field(description="Default values: 80, 443. If custom value is set, field is required. ", alias="controllerPort") 
+    egm_server: AbbControllerEgmServer = Field(alias="egmServer") 
     __properties: ClassVar[List[str]] = ["kind", "controllerIp", "controllerPort", "egmServer"]
 
     @field_validator('kind')

wandelbots_api_client/models/abb_controller_egm_server.py

@@ -5,7 +5,7 @@
 
     Interact with robots in an easy and intuitive way. 
 
-    The version of the OpenAPI document: 1.0.0 beta
+    The version of the OpenAPI document: 1.1.0
     Generated by OpenAPI Generator (https://openapi-generator.tech)
 
     Do not edit the class manually.
@@ -26,8 +26,8 @@ class AbbControllerEgmServer(BaseModel):
     """
     The EGM server runs inside of the cell, thus its IP must be in the same network as the 'controllerIp'
     """ # noqa: E501
-    ip: StrictStr
-    port: StrictInt
+    ip: StrictStr 
+    port: StrictInt 
     __properties: ClassVar[List[str]] = ["ip", "port"]
 
     model_config = ConfigDict(