unique_sdk 0.10.12__py3-none-any.whl → 0.10.14__py3-none-any.whl

unique_sdk/__init__.py

@@ -88,6 +88,10 @@ from unique_sdk.api_resources._message_assessment import (
 )
 from unique_sdk.api_resources._space import Space as Space
 from unique_sdk.api_resources._mcp import MCP as MCP
+from unique_sdk.api_resources._message_execution import (
+    MessageExecution as MessageExecution,
+)
+from unique_sdk.api_resources._message_log import MessageLog as MessageLog
 
 # Unique QL
 from unique_sdk._unique_ql import UQLOperator as UQLOperator

unique_sdk/api_resources/_folder.py

@@ -135,6 +135,15 @@ class Folder(APIResource["Folder"]):
         scopeAccesses: List["Folder.ScopeAccess"]
         applyToSubScopes: bool
 
+    class DeleteFolderParams(TypedDict):
+        """
+        Parameters for deleting a folder.
+        """
+
+        scopeId: NotRequired[str]
+        folderPath: NotRequired[str]
+        recursive: NotRequired[bool]
+
     class GetParams(RequestOptions):
         """
         Parameters for getting a folder by its Id or path.
@@ -152,6 +161,24 @@ class Folder(APIResource["Folder"]):
         take: NotRequired[int]
         skip: NotRequired[int]
 
+    class DeleteFolderResponse(TypedDict):
+        """
+        Response for deleting a folder.
+        """
+
+        id: str
+        name: str
+        path: str
+        failReason: NotRequired[str]
+
+    class DeleteResponse(TypedDict):
+        """
+        Response for deleting a folder.
+        """
+
+        successFolders: List["Folder.DeleteFolderResponse"]
+        failedFolders: List["Folder.DeleteFolderResponse"]
+
     @classmethod
     def get_info(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.GetParams"]
@@ -379,3 +406,86 @@ class Folder(APIResource["Folder"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def delete(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Folder.DeleteFolderParams"],
+    ) -> "Folder.DeleteResponse":
+        """
+        Delete a folder by its ID or path.
+        """
+
+        scopeId = cls.resolve_scope_id(
+            user_id, company_id, params.get("scopeId"), params.get("folderPath")
+        )
+        params.pop("scopeId", None)
+        params.pop("folderPath", None)
+
+        return cast(
+            "Folder.DeleteResponse",
+            cls._static_request(
+                "delete",
+                f"{cls.RESOURCE_URL}/{scopeId}",
+                user_id,
+                company_id=company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def delete_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Folder.DeleteFolderParams"],
+    ) -> "Folder.DeleteResponse":
+        """
+        Async delete a folder by its ID or path.
+        """
+        scopeId = cls.resolve_scope_id(
+            user_id, company_id, params.get("scopeId"), params.get("folderPath")
+        )
+        params.pop("scopeId", None)
+        params.pop("folderPath", None)
+
+        return cast(
+            "Folder.DeleteResponse",
+            await cls._static_request_async(
+                "delete",
+                f"{cls.RESOURCE_URL}/{scopeId}",
+                user_id,
+                company_id=company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def resolve_scope_id(
+        cls,
+        user_id: str,
+        company_id: str,
+        scope_id: str | None = None,
+        folder_path: str | None = None,
+    ) -> str | None:
+        """
+        Returns the scopeId to use: if scope_id is provided, returns it;
+        if not, but folder_path is provided, resolves and returns the id for that folder path.
+        """
+        if scope_id:
+            return scope_id
+        if folder_path:
+            folder_info = cls.get_info(
+                user_id=user_id,
+                company_id=company_id,
+                folderPath=folder_path,
+            )
+            resolved_id = folder_info.get("id")
+            if not resolved_id:
+                raise ValueError(
+                    f"Could not find a folder with folderPath: {folder_path}"
+                )
+            return resolved_id
+        return None

unique_sdk/api_resources/_message_execution.py

@@ -0,0 +1,164 @@
+from typing import ClassVar, Literal, Unpack, cast
+
+from unique_sdk._api_resource import APIResource
+from unique_sdk._request_options import RequestOptions
+
+
+class MessageExecution(APIResource["MessageExecution"]):
+    OBJECT_NAME: ClassVar[Literal["message_execution"]] = "message_execution"
+    RESOURCE_URL = "/message-execution"
+
+    class CreateMessageExecutionParams(RequestOptions):
+        """
+        Parameters for creating a message execution.
+        """
+
+        messageId: str
+        chatId: str
+        type: Literal["DEEP_RESEARCH"] = "DEEP_RESEARCH"
+        secondsRemaining: int | None = None
+        percentageCompleted: int | None = None
+
+    class GetMessageExecutionParams(RequestOptions):
+        """
+        Parameters for getting a message execution.
+        """
+
+        messageId: str
+
+    class UpdateMessageExecutionParams(RequestOptions):
+        """
+        Parameters for updating a message execution.
+        """
+
+        messageId: str
+        status: Literal["COMPLETED", "FAILED"]
+        secondsRemaining: int | None = None
+        percentageCompleted: int | None = None
+
+    messageExecutionId: str | None
+    messageId: str | None
+    status: Literal["PENDING", "RUNNING", "COMPLETED", "FAILED"]
+    type: Literal["DEEP_RESEARCH"] = "DEEP_RESEARCH"
+    secondsRemaining: int | None
+    percentageCompleted: int | None
+    createdAt: str
+    updatedAt: str | None
+
+    @classmethod
+    def create(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageExecution.CreateMessageExecutionParams"],
+    ) -> "MessageExecution":
+        """
+        Create a MessageExecution.
+        """
+        return cast(
+            "MessageExecution",
+            cls._static_request(
+                "post",
+                cls.RESOURCE_URL,
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def create_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageExecution.CreateMessageExecutionParams"],
+    ) -> "MessageExecution":
+        """
+        Async create a MessageExecution.
+        """
+        return cast(
+            "MessageExecution",
+            await cls._static_request_async(
+                "post",
+                cls.RESOURCE_URL,
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def get(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageExecution.GetMessageExecutionParams"],
+    ) -> "MessageExecution":
+        """
+        Get a MessageExecution by its ID.
+        """
+        return cast(
+            "MessageExecution",
+            cls._static_request(
+                "get", cls.RESOURCE_URL, user_id, company_id, params=params
+            ),
+        )
+
+    @classmethod
+    async def get_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageExecution.GetMessageExecutionParams"],
+    ) -> "MessageExecution":
+        """
+        Async get a MessageExecution by its ID.
+        """
+        return cast(
+            "MessageExecution",
+            await cls._static_request_async(
+                "get", cls.RESOURCE_URL, user_id, company_id, params=params
+            ),
+        )
+
+    @classmethod
+    def update(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageExecution.UpdateMessageExecutionParams"],
+    ) -> "MessageExecution":
+        """
+        Update a MessageExecution.
+        """
+        return cast(
+            "MessageExecution",
+            cls._static_request(
+                "patch",
+                cls.RESOURCE_URL,
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def update_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageExecution.UpdateMessageExecutionParams"],
+    ) -> "MessageExecution":
+        """
+        Async update a MessageExecution.
+        """
+        return cast(
+            "MessageExecution",
+            await cls._static_request_async(
+                "patch",
+                cls.RESOURCE_URL,
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )

unique_sdk/api_resources/_message_log.py

@@ -0,0 +1,138 @@
+from typing import ClassVar, Literal, TypedDict, Unpack, cast
+
+from unique_sdk._api_resource import APIResource
+from unique_sdk._request_options import RequestOptions
+
+
+class MessageLog(APIResource["MessageLog"]):
+    OBJECT_NAME: ClassVar[Literal["message_log"]] = "message_log"
+    RESOURCE_URL = "/message-log"
+
+    class Reference(TypedDict):
+        name: str
+        url: str | None
+        sequenceNumber: int
+        originalIndex: list[int] | None
+        sourceId: str
+        source: str
+
+    class CreateMessageLogParams(RequestOptions):
+        """
+        Parameters for creating a message log.
+        """
+
+        messageId: str
+        text: str
+        status: Literal["RUNNING", "COMPLETED", "FAILED"]
+        order: int
+        details: dict | None
+        uncitedReferences: dict | None
+        references: list["MessageLog.Reference"] | None
+
+    class UpdateMessageLogParams(RequestOptions):
+        """
+        Parameters for updating a message log.
+        """
+
+        text: str | None
+        status: Literal["RUNNING", "COMPLETED", "FAILED"] | None
+        order: int
+        details: dict | None
+        uncitedReferences: dict | None
+        references: list["MessageLog.Reference"] | None
+
+    messageLogId: str | None
+    messageId: str | None
+    status: Literal["RUNNING", "COMPLETED", "FAILED"]
+    text: str | None
+    details: dict
+    uncitedReferences: dict
+    order: int
+    createdAt: str
+    updatedAt: str | None
+
+    @classmethod
+    def create(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageLog.CreateMessageLogParams"],
+    ) -> "MessageLog":
+        """
+        Create a MessageLog.
+        """
+        return cast(
+            "MessageLog",
+            cls._static_request(
+                "post",
+                cls.RESOURCE_URL,
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def create_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["MessageLog.CreateMessageLogParams"],
+    ) -> "MessageLog":
+        """
+        Async create a MessageLog.
+        """
+        return cast(
+            "MessageLog",
+            await cls._static_request_async(
+                "post",
+                cls.RESOURCE_URL,
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def update(
+        cls,
+        user_id: str,
+        company_id: str,
+        message_log_id: str,
+        **params: Unpack["MessageLog.UpdateMessageLogParams"],
+    ) -> "MessageLog":
+        """
+        Update a MessageLog.
+        """
+        return cast(
+            "MessageLog",
+            cls._static_request(
+                "patch",
+                f"{cls.RESOURCE_URL}/{message_log_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def update_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        message_log_id: str,
+        **params: Unpack["MessageLog.UpdateMessageLogParams"],
+    ) -> "MessageLog":
+        """
+        Async update a MessageLog.
+        """
+        return cast(
+            "MessageLog",
+            await cls._static_request_async(
+                "patch",
+                f"{cls.RESOURCE_URL}/{message_log_id}",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )

{unique_sdk-0.10.12.dist-info → unique_sdk-0.10.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.12
+Version: 0.10.14
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -1080,6 +1080,34 @@ unique_sdk.Folder.remove_access(
 )
 ```
 
+#### `unique_sdk.Folder.delete` (Compatible with release >.36)
+
+Given a `scopeId` or `folderPath`, the function deletes the folder. If the folder is not empty or if the user has no WRITE access, the delete will fail.
+
+If `recursive` is set to true, the function also deletes its subfolders and its contents, behaving exactly like the `rm -rf`. In case a subfolder has no write access, that folder is considered as failed to delete and the function continues with the other subfolders. At the end, the function returns a list of `successFolders` and `failedFolders`.
+
+Examples:
+Deleting recursively by scope id:
+
+```python
+unique_sdk.Folder.delete(
+   user_id=user_id,
+   company_id=company_id,
+   scopeId="scope_w78wfn114va9o22s13r03yq",
+   recursive=True
+)
+```
+
+Deleting by path (non-recursive):
+
+```python
+unique_sdk.Folder.delete(
+   user_id=user_id,
+   company_id=company_id,
+   folderPath="/Company/Atlas/Due Dilligence/Arch",
+)
+```
+
 ### Space
 
 #### `unique_sdk.Space.delete_chat`
@@ -1488,6 +1516,12 @@ 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.14] - 2025-08-28
+- Add function to delete folders and files recursively
+
+## [0.10.13] - 2025-08-24
+- Add functions to create, get and update a message eecution and create and update a message log.
+
 ## [0.10.12] - 2025-08-24
 - Switch to using Content get info deprecated endpoint to make sure we support older release versions.
 

{unique_sdk-0.10.12.dist-info → unique_sdk-0.10.14.dist-info}/RECORD

@@ -1,4 +1,4 @@
-unique_sdk/__init__.py,sha256=kD6dQiLHr0eJKy5yzN0iRNO7N2v4n9TDv6h6DTHMzoo,3840
+unique_sdk/__init__.py,sha256=iSHCv4LojvIth8YnDhlHvCH6MqeIa3ZQUMFdwj0ipyY,4017
 unique_sdk/_api_requestor.py,sha256=i4gCpzx8zP95sv-AhJfpQxKvWR0U-I6lclHyV55RPtg,14397
 unique_sdk/_api_resource.py,sha256=ytjomI-IVJwsbvdPyuZCfF-bl-Abgf66bu1D34YxCu8,6244
 unique_sdk/_api_version.py,sha256=Ku4JPdeyJtnX5eJJvRCEc1_u44UObdVrvrL1T-WwWCs,46
@@ -20,11 +20,13 @@ unique_sdk/api_resources/_chat_completion.py,sha256=ILCAffxkbkfh2iV9L4KKnfe80gZm
 unique_sdk/api_resources/_content.py,sha256=WQiNdBSE7pe9QV15NXy_kqhEHCqrjH7Xzk3eSK-456c,10723
 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=rDO3rHNddvVWBhM4gaut9WN1A_hASJHiFiAS6a8MszU,9772
+unique_sdk/api_resources/_folder.py,sha256=u_x6g8g_LQsRiJm7ExYuFBxNywfbhOtnSIVK0HwcDws,12820
 unique_sdk/api_resources/_integrated.py,sha256=z_DrftwjgVCi10QQqRYnG5_-95kD7Kfjogbb-dmnJuA,5854
 unique_sdk/api_resources/_mcp.py,sha256=zKh0dyn0QnkKk57N2zlGVN_GQoxEp5T2CS38vVm6jQY,3341
 unique_sdk/api_resources/_message.py,sha256=gEDIzg3METZU2k7m69meAuf0IWmZxnYOjbBKPRMwPYE,7688
 unique_sdk/api_resources/_message_assessment.py,sha256=SSfx6eW7zb_GKe8cFJzCqW-t-_eWEXxKP5cnIb0DhIc,2276
+unique_sdk/api_resources/_message_execution.py,sha256=YzNy7l_BWs8mlEi9TlZL3D_KaecNNRpLmPLUnKeNoQ4,4425
+unique_sdk/api_resources/_message_log.py,sha256=ImBz-b_WDT98NZf8W-gEP4YmjONkpCmX_iZoOjOJQwo,3541
 unique_sdk/api_resources/_search.py,sha256=GQItZKoGNOVZfkLLltBmsRZYBIreRKU0lGW8Kgpj1_Q,1959
 unique_sdk/api_resources/_search_string.py,sha256=4Idw6exgZdA8qksz9WkiA68k1hTU-7yFkgT_OLU_GkE,1662
 unique_sdk/api_resources/_short_term_memory.py,sha256=vPRN-Y0WPx74E6y-A3LocGc0TxJdzT-xGL66WzZwKRg,2820
@@ -34,7 +36,7 @@ unique_sdk/utils/chat_in_space.py,sha256=3NeBjOu7p43V_6PrjwxyaTkgknUS10KE4QRuTlF
 unique_sdk/utils/file_io.py,sha256=YY8B7VJcTLOPmCXByiOfNerXGlAtjCC5EVNmAbQJ3dQ,4306
 unique_sdk/utils/sources.py,sha256=DoxxhMLcLhmDfNarjXa41H4JD2GSSDywr71hiC-4pYc,4952
 unique_sdk/utils/token.py,sha256=AzKuAA1AwBtnvSFxGcsHLpxXr_wWE5Mj4jYBbOz2ljA,1740
-unique_sdk-0.10.12.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
-unique_sdk-0.10.12.dist-info/METADATA,sha256=l4d5TX7cZpHkoDLMzELqS5Mem-WI1sLXkNHaiYtjPmk,50842
-unique_sdk-0.10.12.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_sdk-0.10.12.dist-info/RECORD,,
+unique_sdk-0.10.14.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
+unique_sdk-0.10.14.dist-info/METADATA,sha256=c86qxzAaH_N2geRx77kekrdWl7fTEL2oOvlBKXCfXWk,51988
+unique_sdk-0.10.14.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_sdk-0.10.14.dist-info/RECORD,,