unique_sdk 0.10.43__py3-none-any.whl → 0.10.47__py3-none-any.whl

unique_sdk/api_resources/_content.py

@@ -29,6 +29,7 @@ class Content(APIResource["Content"]):
     metadata: Optional[Dict[str, Any]]
     writeUrl: Optional[str]
     readUrl: Optional[str]
+    expiredAt: Optional[str]
 
     class QueryMode(Enum):
         Default = "default"

unique_sdk/api_resources/_group.py

@@ -25,6 +25,15 @@ class Group(APIResource["Group"]):
         take: NotRequired[Optional[int]]
         name: NotRequired[Optional[str]]
 
+    class CreateParams(RequestOptions):
+        """
+        Parameters for creating a group.
+        """
+
+        name: str
+        externalId: NotRequired[Optional[str]]
+        parentId: NotRequired[Optional[str]]
+
     class UpdateParams(RequestOptions):
         """
         Parameters for updating a group.
@@ -32,6 +41,20 @@ class Group(APIResource["Group"]):
 
         name: NotRequired[Optional[str]]
 
+    class AddUsersParams(RequestOptions):
+        """
+        Parameters for adding users to a group.
+        """
+
+        userIds: List[str]
+
+    class RemoveUsersParams(RequestOptions):
+        """
+        Parameters for removing users from a group.
+        """
+
+        userIds: List[str]
+
     class GroupMember(TypedDict):
         """
         Represents a member of a group.
@@ -39,6 +62,15 @@ class Group(APIResource["Group"]):
 
         entityId: str
 
+    class GroupMembership(TypedDict):
+        """
+        Represents a membership relationship between a user and a group.
+        """
+
+        entityId: str
+        groupId: str
+        createdAt: str
+
     class Group(TypedDict):
         """
         Represents a group in the company.
@@ -48,7 +80,6 @@ class Group(APIResource["Group"]):
         name: str
         externalId: str
         parentId: Optional[str]
-        roles: Optional[List[str]]
         members: Optional[List["Group.GroupMember"]]
         createdAt: str
         updatedAt: str
@@ -67,6 +98,62 @@ class Group(APIResource["Group"]):
 
         id: str
 
+    class AddUsersToGroupResponse(TypedDict):
+        """
+        Response for adding users to a group.
+        """
+
+        memberships: List["Group.GroupMembership"]
+
+    class RemoveUsersFromGroupResponse(TypedDict):
+        """
+        Response for removing users from a group.
+        """
+
+        success: bool
+
+    @classmethod
+    def create_group(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Group.CreateParams"],
+    ) -> "Group.Group":
+        """
+        Create a group in a company.
+        """
+        return cast(
+            "Group.Group",
+            cls._static_request(
+                "post",
+                "/groups",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def create_group_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Group.CreateParams"],
+    ) -> "Group.Group":
+        """
+        Async create a group in a company.
+        """
+        return cast(
+            "Group.Group",
+            await cls._static_request_async(
+                "post",
+                "/groups",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
     @classmethod
     def get_groups(
         cls,
@@ -192,3 +279,91 @@ class Group(APIResource["Group"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def add_users_to_group(
+        cls,
+        user_id: str,
+        company_id: str,
+        group_id: str,
+        **params: Unpack["Group.AddUsersParams"],
+    ) -> "Group.AddUsersToGroupResponse":
+        """
+        Add users to a group in a company.
+        """
+        return cast(
+            "Group.AddUsersToGroupResponse",
+            cls._static_request(
+                "post",
+                f"/groups/{group_id}/users",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def add_users_to_group_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        group_id: str,
+        **params: Unpack["Group.AddUsersParams"],
+    ) -> "Group.AddUsersToGroupResponse":
+        """
+        Async add users to a group in a company.
+        """
+        return cast(
+            "Group.AddUsersToGroupResponse",
+            await cls._static_request_async(
+                "post",
+                f"/groups/{group_id}/users",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def remove_users_from_group(
+        cls,
+        user_id: str,
+        company_id: str,
+        group_id: str,
+        **params: Unpack["Group.RemoveUsersParams"],
+    ) -> "Group.RemoveUsersFromGroupResponse":
+        """
+        Remove users from a group in a company.
+        """
+        return cast(
+            "Group.RemoveUsersFromGroupResponse",
+            cls._static_request(
+                "delete",
+                f"/groups/{group_id}/users",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def remove_users_from_group_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        group_id: str,
+        **params: Unpack["Group.RemoveUsersParams"],
+    ) -> "Group.RemoveUsersFromGroupResponse":
+        """
+        Async remove users from a group in a company.
+        """
+        return cast(
+            "Group.RemoveUsersFromGroupResponse",
+            await cls._static_request_async(
+                "delete",
+                f"/groups/{group_id}/users",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )

unique_sdk/api_resources/_space.py

@@ -29,6 +29,14 @@ class Space(APIResource["Space"]):
         toolChoices: NotRequired[List[str] | None]
         scopeRules: NotRequired[dict | None]
 
+    class GetChatMessagesParams(RequestOptions):
+        """
+        Parameters for getting chat messages.
+        """
+
+        skip: NotRequired[int]
+        take: NotRequired[int]
+
     class Reference(TypedDict):
         """
         Reference information for a message.
@@ -86,6 +94,14 @@ class Space(APIResource["Space"]):
 
         chat_id: str
 
+    class GetAllMessagesResponse(TypedDict):
+        """
+        Response for getting all messages in a chat.
+        """
+
+        messages: List["Space.Message"]
+        totalCount: int
+
     @classmethod
     def create_message(
         cls,
@@ -130,6 +146,50 @@ class Space(APIResource["Space"]):
             ),
         )
 
+    @classmethod
+    def get_chat_messages(
+        cls,
+        user_id: str,
+        company_id: str,
+        chat_id: str,
+        **params: Unpack["Space.GetChatMessagesParams"],
+    ) -> "Space.GetAllMessagesResponse":
+        """
+        Get all messages in a space chat.
+        """
+        return cast(
+            "Space.GetAllMessagesResponse",
+            cls._static_request(
+                "get",
+                f"/space/chat/{chat_id}/messages",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def get_chat_messages_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        chat_id: str,
+        **params: Unpack["Space.GetChatMessagesParams"],
+    ) -> "Space.GetAllMessagesResponse":
+        """
+        Async get all messages in a space chat.
+        """
+        return cast(
+            "Space.GetAllMessagesResponse",
+            await cls._static_request_async(
+                "get",
+                f"/space/chat/{chat_id}/messages",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
     @classmethod
     def get_latest_message(
         cls, user_id: str, company_id: str, chat_id: str

unique_sdk/utils/chat_in_space.py

@@ -76,6 +76,7 @@ async def chat_against_file(
     text: str,
     poll_interval: float = 1.0,
     max_wait: float = 60.0,
+    should_delete_chat: bool = True,
 ) -> "Space.Message":
     """
     Chat against a file by uploading it, sending a message and waiting for a reply.
@@ -140,8 +141,8 @@ async def chat_against_file(
         print(f"Error during chat against file: {err}")
         raise
     finally:
-        if chat_id:
-            Space.delete_chat(
+        if chat_id and should_delete_chat:
+            await Space.delete_chat_async(
                 user_id=user_id,
                 company_id=company_id,
                 chat_id=chat_id,

{unique_sdk-0.10.43.dist-info → unique_sdk-0.10.47.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.43
+Version: 0.10.47
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -1392,6 +1392,20 @@ message = unique_sdk.Space.create_message(
 )
 ```
 
+#### `unique_sdk.Space.get_chat_messages` (Compatible with release >.48)
+
+Get all messages in a space chat. Returns a list of paginated messages in the specified chat.
+
+```python
+messages = unique_sdk.Space.get_chat_messages(
+    user_id=user_id,
+    company_id=company_id,
+    chat_id="chat_dejfhe729br398",
+    skip=0,  # Optional (defaults to 0) - number of messages to skip for pagination
+    take=50,  # Optional (defaults to 10) - number of messages to return
+)
+```
+
 #### `unique_sdk.Space.get_latest_message`
 
 Get the latest message in a space chat.
@@ -1449,6 +1463,20 @@ users = unique_sdk.User.get_users(
 
 ### Group
 
+#### `unique_sdk.Group.create_group` (Compatible with release >.48)
+
+Create a new group in a company. You can specify the group name (required), external ID and parent group ID.
+
+```python
+group = unique_sdk.Group.create_group(
+    user_id=user_id,
+    company_id=company_id,
+    name="New Group",  # Required - the name of the group
+    externalId="ext_123",  # Optional - external ID for the group
+    parentId="group_a9cs7wr2z1bg2sxczvltgjch",  # Optional - parent group ID
+)
+```
+
 #### `unique_sdk.Group.get_groups` (Compatible with release >.48)
 
 Get groups in a company. You can filter by name and use pagination with skip and take parameters.
@@ -1471,11 +1499,37 @@ Update a group in a company. You can update the group's name.
 updated_group = unique_sdk.Group.update_group(
     user_id=user_id,
     company_id=company_id,
-    group_id="group_id_here",
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
     name="New Group Name",  # Optional - update the group name
 )
 ```
 
+#### `unique_sdk.Group.add_users_to_group` (Compatible with release >.48)
+
+Add users to a group. Provide an array of user IDs to add as members to the specified group.
+
+```python
+result = unique_sdk.Group.add_users_to_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    userIds=["299420877169688584", "325402458132058201", "299426678160031752"],  # Required - array of user IDs to add
+)
+```
+
+#### `unique_sdk.Group.remove_users_from_group` (Compatible with release >.48)
+
+Remove users from a group. Provide an array of user IDs to remove from the specified group.
+
+```python
+result = unique_sdk.Group.remove_users_from_group(
+    user_id=user_id,
+    company_id=company_id,
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
+    userIds=["299426678160031752", "299426678160031752"],  # Required - array of user IDs to remove
+)
+```
+
 #### `unique_sdk.Group.delete_group` (Compatible with release >.48)
 
 Delete a group in a company by its group ID.
@@ -1484,7 +1538,7 @@ Delete a group in a company by its group ID.
 result = unique_sdk.Group.delete_group(
     user_id=user_id,
     company_id=company_id,
-    group_id="group_id_here",
+    group_id="group_a9cs7wr2z1bg2sxczvltgjch",
 )
 ```
 
@@ -2032,11 +2086,12 @@ You must provide the following parameters:
 - `mime_type`: The mime type of the ifle to be uploaded.
 - `text`: The text to be sent to the chat for chatting against the file.
 
-The script creates a chat and uploads the file to it. It then keeps polling the `ingestionState` field of the message, waiting for it to reach `FINISHED`, signaling the upload is complete. Once the file uploads successfully, the script sends the text, continues polling for completion, and finally retrieves the response message.
+The script creates a chat and uploads the file to it. It then keeps polling the `ingestionState` field of the message, waiting for it to reach `FINISHED`, signaling the upload is complete. Once the file uploads successfully, the script sends the text, continues polling for completion, and finally retrieves the response message. The function deletes the chat at the end unless the `should_delete_chat` is set to false.
 
 **Optional parameters:**
 - `poll_interval`: The number of seconds to wait between polling attempts (default: `1` second).
 - `max_wait`: The maximum number of seconds to wait for the message to complete (default: `60` seconds).
+- `should_delete_chat`: Setting this flag determines whether the chat should be deleted at the end or not. Default is True.
 
 Example of chatting against a PDF. (The usage can be extended to any supported file type)
 
@@ -2046,8 +2101,8 @@ latest_message = await unique_sdk.utils.chat_in_space.chat_against_file(
     company_id=company_id,
     assistant_id="assistant_hjcdga64bkcjnhu4",
     path_to_file="/files/hello.pdf",
-    displayed_filename="hello.pdf"
-    mime_type="application/pdf"
+    displayed_filename="hello.pdf",
+    mime_type="application/pdf",
     text="Give me a bullet point summary of the file.",
 )
 ```
@@ -2093,6 +2148,18 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), 
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.10.47] - 2025-11-19
+- Add expired/s at fields on content search result.
+
+## [0.10.46] - 2025-11-18
+- chat_against_file function allows now a should_delete_chat flag.
+
+## [0.10.45] - 2025-11-18
+- Create group and manage users functions.
+
+## [0.10.44] - 2025-11-18
+- add function to get all messages in a chat.
+
 ## [0.10.43] - 2025-11-14
 - Add get, delete and update groups functions.
 

{unique_sdk-0.10.43.dist-info → unique_sdk-0.10.47.dist-info}/RECORD

@@ -17,11 +17,11 @@ unique_sdk/api_resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 unique_sdk/api_resources/_acronyms.py,sha256=GIU1XH1flGWQYcpsFqTYwg4ioIGxVmb15tux84nmhEg,891
 unique_sdk/api_resources/_agentic_table.py,sha256=8-_f7t-m_iiiOj2835iESoxz91YRxl4-tkxpzQbgdcI,9958
 unique_sdk/api_resources/_chat_completion.py,sha256=ILCAffxkbkfh2iV9L4KKnfe80gZmT9pWfkNmf3mq68U,2172
-unique_sdk/api_resources/_content.py,sha256=Z7BU2bw1qULnn-UBX0f6ix_XV0qI1yaRH6zOSgtMvho,17514
+unique_sdk/api_resources/_content.py,sha256=vRynwj4QBZA1v2CVg_xbhmLqqh3m4cPGMoLeFZTaSYA,17543
 unique_sdk/api_resources/_embedding.py,sha256=C6qak7cCUBMBINfPhgH8taCJZ9n6w1MUElqDJJ8dG10,1281
 unique_sdk/api_resources/_event.py,sha256=bpWF9vstdoAWbUzr-iiGP713ceP0zPk77GJXiImf9zg,374
 unique_sdk/api_resources/_folder.py,sha256=WPyRPsdAE62tU7p4hEYiVB4OoArv_60b8t4j7hgrJKk,15765
-unique_sdk/api_resources/_group.py,sha256=f3spoWF0fX0rZkWrJZdalBMLkwRtccNOSSxFadypum0,4341
+unique_sdk/api_resources/_group.py,sha256=KnuUkk9RxNPLTMBShCxJxNKcfx90yogt4BNoGU5lmRk,8685
 unique_sdk/api_resources/_integrated.py,sha256=O8e673z-RB7FRFMQYn_YEuHijebr5W7KJxkUnymbBZk,6164
 unique_sdk/api_resources/_llm_models.py,sha256=3Jn6MpxWgZ43Hze8JHd4_n27si5xmwd3JE8r8cEZq_M,1640
 unique_sdk/api_resources/_mcp.py,sha256=zKh0dyn0QnkKk57N2zlGVN_GQoxEp5T2CS38vVm6jQY,3341
@@ -32,14 +32,14 @@ unique_sdk/api_resources/_message_log.py,sha256=_DifZ4Di7uKyzkP0i8rwu5IIiYZPCBp5
 unique_sdk/api_resources/_search.py,sha256=GQItZKoGNOVZfkLLltBmsRZYBIreRKU0lGW8Kgpj1_Q,1959
 unique_sdk/api_resources/_search_string.py,sha256=LZz2_QPZXV1NXucRR06dnDC2miK7J8XBY7dXX2xoDY4,1610
 unique_sdk/api_resources/_short_term_memory.py,sha256=vPRN-Y0WPx74E6y-A3LocGc0TxJdzT-xGL66WzZwKRg,2820
-unique_sdk/api_resources/_space.py,sha256=JjIPauH37wULEiNO5PqOfgsipyfbRlC0KqjJ4_1Uugg,5035
+unique_sdk/api_resources/_space.py,sha256=yQGoK3o8YbaEdoJvrWzx97Rbx_kdhRKNVsE1jdw_a5E,6580
 unique_sdk/api_resources/_user.py,sha256=u59Hgq9i-QhYlqIYgk-KE7OeSx5xuNVo_gUgDpZTLcI,1974
 unique_sdk/utils/chat_history.py,sha256=5UqL9hF1O9pV7skbNOlEibF5rHdYsmG3m5-YEPUowOs,3037
-unique_sdk/utils/chat_in_space.py,sha256=cdjETBLnjv-OE8qsQpm626ks5yBdfQG_KBeG0WIzCbY,5994
+unique_sdk/utils/chat_in_space.py,sha256=e_Ny03eB7Q8oijdUR_sPlFTIgq2rsCbSR-Sin8jnxM8,6066
 unique_sdk/utils/file_io.py,sha256=lskRULIh7qExK26o_1YqRs0f5mqJHTS9m_mdxlsVo4s,4497
 unique_sdk/utils/sources.py,sha256=DoxxhMLcLhmDfNarjXa41H4JD2GSSDywr71hiC-4pYc,4952
 unique_sdk/utils/token.py,sha256=AzKuAA1AwBtnvSFxGcsHLpxXr_wWE5Mj4jYBbOz2ljA,1740
-unique_sdk-0.10.43.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
-unique_sdk-0.10.43.dist-info/METADATA,sha256=KdrdST-aefdKEsL0BaXUxAm4IyhnZSwc4TcKVDEVOBA,71736
-unique_sdk-0.10.43.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_sdk-0.10.43.dist-info/RECORD,,
+unique_sdk-0.10.47.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
+unique_sdk-0.10.47.dist-info/METADATA,sha256=EwP9zbqw4sD462AvIvxAElpPxcbtdY27fePcUE9SdOY,74141
+unique_sdk-0.10.47.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_sdk-0.10.47.dist-info/RECORD,,