unique_sdk 0.10.61__tar.gz → 0.10.64__tar.gz

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/CHANGELOG.md

@@ -5,6 +5,15 @@ 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.64] - 2025-12-31
+- Add create path functionality to theupsert function and allow getinfo(s) to query by parentfolderpath.
+
+## [0.10.63] - 2025-12-23
+- Add functions to create a space and manage its access.
+
+## [0.10.62] - 2025-12-23
+- Add get user groups function and allow the get users function to filter by username.
+
 ## [0.10.61] - 2025-12-22
 - Add `displayInChat` field to ingestion config, allowing silent uploads to chat.
 

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.61
+Version: 0.10.64
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -28,6 +28,15 @@ 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.64] - 2025-12-31
+- Add create path functionality to theupsert function and allow getinfo(s) to query by parentfolderpath.
+
+## [0.10.63] - 2025-12-23
+- Add functions to create a space and manage its access.
+
+## [0.10.62] - 2025-12-23
+- Add get user groups function and allow the get users function to filter by username.
+
 ## [0.10.61] - 2025-12-22
 - Add `displayInChat` field to ingestion config, allowing silent uploads to chat.
 

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_sdk"
-version = "0.10.61"
+version = "0.10.64"
 description = ""
 authors = [
     "Martin Fadler <martin.fadler@unique.ch>",

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/unique_sdk/api_resources/_content.py

@@ -110,6 +110,7 @@ class Content(APIResource["Content"]):
         skip: NotRequired[int | None]
         take: NotRequired[int | None]
         parentId: NotRequired[str | None]
+        parentFolderPath: NotRequired[str | None]
 
     class CustomApiOptions(TypedDict):
         apiIdentifier: str
@@ -149,6 +150,8 @@ class Content(APIResource["Content"]):
     class UpsertParams(RequestOptions):
         input: "Content.Input"
         scopeId: NotRequired[str | None]
+        parentFolderPath: NotRequired[str | None]
+        createFolderIfNotExists: NotRequired[bool | None]
         chatId: NotRequired[str | None]
         sourceOwnerType: NotRequired[str | None]
         storeInternally: NotRequired[bool | None]
@@ -315,6 +318,16 @@ class Content(APIResource["Content"]):
         company_id: str,
         **params: Unpack["Content.ContentInfosParams"],
     ) -> "Content.PaginatedContentInfos":
+        parent_id = unique_sdk.Folder.resolve_scope_id_from_folder_path(
+            user_id=user_id,
+            company_id=company_id,
+            scope_id=params.get("parentId"),
+            folder_path=params.get("parentFolderPath"),
+        )
+        params.pop("parentFolderPath", None)
+        if parent_id:
+            params["parentId"] = parent_id
+
         return cast(
             Content.PaginatedContentInfos,
             cls._static_request(
@@ -333,6 +346,16 @@ class Content(APIResource["Content"]):
         company_id: str,
         **params: Unpack["Content.ContentInfosParams"],
     ) -> "Content.PaginatedContentInfos":
+        parent_id = await unique_sdk.Folder.resolve_scope_id_from_folder_path_async(
+            user_id=user_id,
+            company_id=company_id,
+            scope_id=params.get("parentId"),
+            folder_path=params.get("parentFolderPath"),
+        )
+        params.pop("parentFolderPath", None)
+        if parent_id:
+            params["parentId"] = parent_id
+
         return cast(
             Content.PaginatedContentInfos,
             await cls._static_request_async(
@@ -359,6 +382,19 @@ class Content(APIResource["Content"]):
             if "description" in params["input"] and not params["input"]["description"]:
                 params["input"].pop("description")
 
+        create_folder = params.get("createFolderIfNotExists")
+        scope_id = unique_sdk.Folder.resolve_scope_id_from_folder_path_with_create(
+            user_id=user_id,
+            company_id=company_id,
+            scope_id=params.get("scopeId"),
+            folder_path=params.get("parentFolderPath"),
+            create_if_not_exists=create_folder if create_folder is not None else True,
+        )
+        params.pop("parentFolderPath", None)
+        params.pop("createFolderIfNotExists", None)
+        if scope_id:
+            params["scopeId"] = scope_id
+
         return cast(
             "Content",
             cls._static_request(
@@ -385,6 +421,23 @@ class Content(APIResource["Content"]):
             if "description" in params["input"] and not params["input"]["description"]:
                 params["input"].pop("description")
 
+        create_folder = params.get("createFolderIfNotExists")
+        scope_id = (
+            await unique_sdk.Folder.resolve_scope_id_from_folder_path_with_create_async(
+                user_id=user_id,
+                company_id=company_id,
+                scope_id=params.get("scopeId"),
+                folder_path=params.get("parentFolderPath"),
+                create_if_not_exists=create_folder
+                if create_folder is not None
+                else True,
+            )
+        )
+        params.pop("parentFolderPath", None)
+        params.pop("createFolderIfNotExists", None)
+        if scope_id:
+            params["scopeId"] = scope_id
+
         return cast(
             "Content",
             await cls._static_request_async(
@@ -481,7 +534,7 @@ class Content(APIResource["Content"]):
             params.get("contentId"),
             params.get("filePath"),
         )
-        owner_id = unique_sdk.Folder.resolve_scope_id_from_folder_path(
+        owner_id = await unique_sdk.Folder.resolve_scope_id_from_folder_path_async(
             user_id,
             company_id,
             params.get("ownerId"),

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/unique_sdk/api_resources/_folder.py

@@ -157,6 +157,7 @@ class Folder(APIResource["Folder"]):
         """
 
         parentId: NotRequired[str]
+        parentFolderPath: NotRequired[str]
         take: NotRequired[int]
         skip: NotRequired[int]
 
@@ -268,6 +269,16 @@ class Folder(APIResource["Folder"]):
         """
         Get paginated folders based on parentId. If the parentId is not defined, the root folders will be returned.
         """
+        parent_id = cls.resolve_scope_id_from_folder_path(
+            user_id=user_id,
+            company_id=company_id,
+            scope_id=params.get("parentId"),
+            folder_path=params.get("parentFolderPath"),
+        )
+        params.pop("parentFolderPath", None)
+        if parent_id:
+            params["parentId"] = parent_id
+
         return cast(
             "Folder.FolderInfos",
             cls._static_request(
@@ -286,6 +297,16 @@ class Folder(APIResource["Folder"]):
         """
         Async get paginated folders based on parentId. If the parentId is not defined, the root folders will be returned.
         """
+        parent_id = await cls.resolve_scope_id_from_folder_path_async(
+            user_id=user_id,
+            company_id=company_id,
+            scope_id=params.get("parentId"),
+            folder_path=params.get("parentFolderPath"),
+        )
+        params.pop("parentFolderPath", None)
+        if parent_id:
+            params["parentId"] = parent_id
+
         return cast(
             "Folder.FolderInfos",
             await cls._static_request_async(
@@ -617,3 +638,116 @@ class Folder(APIResource["Folder"]):
                 )
             return resolved_id
         return None
+
+    @classmethod
+    def resolve_scope_id_from_folder_path_with_create(
+        cls,
+        user_id: str,
+        company_id: str,
+        scope_id: str | None = None,
+        folder_path: str | None = None,
+        create_if_not_exists: bool = True,
+    ) -> str | None:
+        if scope_id:
+            return scope_id
+        if folder_path:
+            try:
+                folder_info = cls.get_info(
+                    user_id=user_id,
+                    company_id=company_id,
+                    folderPath=folder_path,
+                )
+                resolved_id = folder_info.get("id")
+                if resolved_id:
+                    return resolved_id
+            except Exception:
+                pass
+
+            if create_if_not_exists:
+                result = cls.create_paths(
+                    user_id=user_id,
+                    company_id=company_id,
+                    paths=[folder_path],
+                )
+                created_folders = result.get("createdFolders", [])
+                if created_folders:
+                    return created_folders[-1]["id"]
+                raise ValueError(
+                    f"Failed to create folder with folderPath: {folder_path}"
+                )
+
+            raise ValueError(f"Could not find a folder with folderPath: {folder_path}")
+        return None
+
+    @classmethod
+    async def resolve_scope_id_from_folder_path_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        scope_id: str | None = None,
+        folder_path: str | None = None,
+    ) -> str | None:
+        """
+        Async version of resolve_scope_id_from_folder_path.
+        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.
+
+        Returns:
+            str: The resolved folder ID.
+            None: Failed to resolve a folder ID (e.g., folder_path not found or not provided).
+        """
+        if scope_id:
+            return scope_id
+        if folder_path:
+            folder_info = await cls.get_info_async(
+                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
+
+    @classmethod
+    async def resolve_scope_id_from_folder_path_with_create_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        scope_id: str | None = None,
+        folder_path: str | None = None,
+        create_if_not_exists: bool = True,
+    ) -> str | None:
+        if scope_id:
+            return scope_id
+        if folder_path:
+            try:
+                folder_info = await cls.get_info_async(
+                    user_id=user_id,
+                    company_id=company_id,
+                    folderPath=folder_path,
+                )
+                resolved_id = folder_info.get("id")
+                if resolved_id:
+                    return resolved_id
+            except Exception:
+                pass
+
+            if create_if_not_exists:
+                result = await cls.create_paths_async(
+                    user_id=user_id,
+                    company_id=company_id,
+                    paths=[folder_path],
+                )
+                created_folders = result.get("createdFolders", [])
+                if created_folders:
+                    return created_folders[-1]["id"]
+                raise ValueError(
+                    f"Failed to create folder with folderPath: {folder_path}"
+                )
+
+            raise ValueError(f"Could not find a folder with folderPath: {folder_path}")
+        return None

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/unique_sdk/api_resources/_space.py

@@ -18,6 +18,43 @@ from unique_sdk._request_options import RequestOptions
 class Space(APIResource["Space"]):
     OBJECT_NAME: ClassVar[Literal["space"]] = "space"
 
+    class ModuleParams(TypedDict):
+        name: str
+        description: NotRequired[Optional[str]]
+        weight: NotRequired[Optional[int]]
+        isExternal: NotRequired[Optional[bool]]
+        isCustomInstructionEnabled: NotRequired[Optional[bool]]
+        configuration: NotRequired[Optional[Dict[str, Any]]]
+        toolDefinition: NotRequired[Optional[Dict[str, Any]]]
+
+    class CreateSpaceParams(RequestOptions):
+        name: str
+        fallbackModule: str
+        modules: List["Space.ModuleParams"]
+        explanation: NotRequired[Optional[str]]
+        alert: NotRequired[Optional[str]]
+        chatUpload: NotRequired[Optional[Literal["ENABLED", "DISABLED"]]]
+        languageModel: NotRequired[Optional[str]]
+        isExternal: NotRequired[Optional[bool]]
+        isPinned: NotRequired[Optional[bool]]
+        uiType: NotRequired[
+            Optional[
+                Literal["MAGIC_TABLE", "UNIQUE_CUSTOM", "TRANSLATION", "UNIQUE_AI"]
+            ]
+        ]
+        settings: NotRequired[Optional[Dict[str, Any]]]
+
+    class AccessEntry(TypedDict):
+        entityId: str
+        entityType: Literal["USER", "GROUP"]
+        type: Literal["USE", "MANAGE", "UPLOAD"]
+
+    class AddSpaceAccessParams(RequestOptions):
+        access: List["Space.AccessEntry"]
+
+    class DeleteSpaceAccessParams(RequestOptions):
+        accessIds: List[str]
+
     class CreateMessageParams(RequestOptions):
         """
         Parameters for querying the assistant for a message.
@@ -104,9 +141,9 @@ class Space(APIResource["Space"]):
         messages: List["Space.Message"]
         totalCount: int
 
-    class AssistantMcpServer(TypedDict):
+    class McpServer(TypedDict):
         """
-        Represents an MCP server associated with an assistant.
+        Represents an MCP server associated with a space.
         """
 
         id: str
@@ -149,16 +186,18 @@ class Space(APIResource["Space"]):
         createdAt: str
         updatedAt: str
 
-    class AssistantAccess(TypedDict):
-        """
-        Represents access control for a space.
-        """
-
+    class Access(TypedDict):
         id: str
         entityId: str
         entityType: str
         type: str
 
+    class SpaceAccessResponse(TypedDict):
+        access: List["Space.Access"]
+
+    class DeleteSpaceAccessResponse(TypedDict):
+        success: bool
+
     id: str
     name: str
     defaultForCompanyId: Optional[str]
@@ -177,10 +216,10 @@ class Space(APIResource["Space"]):
     isPinned: bool
     uiType: str
     settings: Optional[Dict[str, Any]]
-    assistantMcpServers: List["Space.AssistantMcpServer"]
+    assistantMcpServers: List["Space.McpServer"]
     modules: List["Space.Module"]
     scopeRules: List["Space.ScopeRule"]
-    assistantAccess: List["Space.AssistantAccess"]
+    assistantAccess: List["Space.Access"]
     createdAt: str
     updatedAt: str
 
@@ -385,3 +424,149 @@ class Space(APIResource["Space"]):
                 company_id,
             ),
         )
+
+    @classmethod
+    def create_space(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Space.CreateSpaceParams"],
+    ) -> "Space":
+        return cast(
+            "Space",
+            cls._static_request(
+                "post",
+                "/space",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def create_space_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Space.CreateSpaceParams"],
+    ) -> "Space":
+        return cast(
+            "Space",
+            await cls._static_request_async(
+                "post",
+                "/space",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def get_space_access(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space.SpaceAccessResponse":
+        return cast(
+            "Space.SpaceAccessResponse",
+            cls._static_request(
+                "get",
+                f"/space/{space_id}/access",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def get_space_access_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+    ) -> "Space.SpaceAccessResponse":
+        return cast(
+            "Space.SpaceAccessResponse",
+            await cls._static_request_async(
+                "get",
+                f"/space/{space_id}/access",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    def add_space_access(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+        **params: Unpack["Space.AddSpaceAccessParams"],
+    ) -> "Space.SpaceAccessResponse":
+        return cast(
+            "Space.SpaceAccessResponse",
+            cls._static_request(
+                "post",
+                f"/space/{space_id}/access",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def add_space_access_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+        **params: Unpack["Space.AddSpaceAccessParams"],
+    ) -> "Space.SpaceAccessResponse":
+        return cast(
+            "Space.SpaceAccessResponse",
+            await cls._static_request_async(
+                "post",
+                f"/space/{space_id}/access",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def delete_space_access(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+        **params: Unpack["Space.DeleteSpaceAccessParams"],
+    ) -> "Space.DeleteSpaceAccessResponse":
+        return cast(
+            "Space.DeleteSpaceAccessResponse",
+            cls._static_request(
+                "delete",
+                f"/space/{space_id}/access",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def delete_space_access_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        space_id: str,
+        **params: Unpack["Space.DeleteSpaceAccessParams"],
+    ) -> "Space.DeleteSpaceAccessResponse":
+        return cast(
+            "Space.DeleteSpaceAccessResponse",
+            await cls._static_request_async(
+                "delete",
+                f"/space/{space_id}/access",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )

{unique_sdk-0.10.61 → unique_sdk-0.10.64}/unique_sdk/api_resources/_user.py

@@ -26,6 +26,7 @@ class User(APIResource["User"]):
         take: NotRequired[Optional[int]]
         email: NotRequired[Optional[str]]
         displayName: NotRequired[Optional[str]]
+        userName: NotRequired[Optional[str]]
 
     class UpdateUserConfigurationParams(RequestOptions):
         """
@@ -34,6 +35,17 @@ class User(APIResource["User"]):
 
         userConfiguration: Dict[str, Any]
 
+    class UserGroup(TypedDict):
+        id: str
+        name: str
+        externalId: Optional[str]
+        parentId: Optional[str]
+        createdAt: str
+        updatedAt: str
+
+    class UserGroupsResponse(TypedDict):
+        groups: List["User.UserGroup"]
+
     class User(TypedDict):
         """
         Represents a user in the company.
@@ -147,3 +159,37 @@ class User(APIResource["User"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def get_user_groups(
+        cls,
+        user_id: str,
+        company_id: str,
+        target_user_id: str,
+    ) -> "User.UserGroupsResponse":
+        return cast(
+            "User.UserGroupsResponse",
+            cls._static_request(
+                "get",
+                f"/users/{target_user_id}/groups",
+                user_id,
+                company_id,
+            ),
+        )
+
+    @classmethod
+    async def get_user_groups_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        target_user_id: str,
+    ) -> "User.UserGroupsResponse":
+        return cast(
+            "User.UserGroupsResponse",
+            await cls._static_request_async(
+                "get",
+                f"/users/{target_user_id}/groups",
+                user_id,
+                company_id,
+            ),
+        )