unique_sdk 0.10.62__py3-none-any.whl → 0.10.66__py3-none-any.whl

unique_sdk/api_resources/_content.py

@@ -30,6 +30,7 @@ class Content(APIResource["Content"]):
     writeUrl: Optional[str]
     readUrl: Optional[str]
     expiredAt: Optional[str]
+    appliedIngestionConfig: Optional[Dict[str, Any]]
 
     class QueryMode(Enum):
         Default = "default"
@@ -110,6 +111,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 +151,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 +319,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 +347,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 +383,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 +422,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 +535,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/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/api_resources/_mcp.py

@@ -59,6 +59,8 @@ class MCP(APIResource["MCP"]):
         """Parameters for calling an MCP tool."""
 
         name: str
+        messageId: str
+        chatId: str
         arguments: Dict[str, Any]
 
     # Response fields

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.62.dist-info → unique_sdk-0.10.66.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.62
+Version: 0.10.66
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -28,8 +28,20 @@ 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.66] - 2026-01-05
+- Expose appliedIngestionConfig field on content search.
+
+## [0.10.65] - 2025-01-05
+- Add new params for elicitation to `call_tool` api
+
+## [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 gorups function and allow the get users function to filter by username.
+- 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.62.dist-info → unique_sdk-0.10.66.dist-info}/RECORD

@@ -17,14 +17,14 @@ 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=omdF4vbGCsjuQpPhuMUwaaGAb9nXscEUZsqUz3cz2AY,10353
 unique_sdk/api_resources/_chat_completion.py,sha256=ILCAffxkbkfh2iV9L4KKnfe80gZmT9pWfkNmf3mq68U,2172
-unique_sdk/api_resources/_content.py,sha256=GT8vdCF1CygQay4lqacVQTQxPuLk94yzWoZpcd1G08U,17670
+unique_sdk/api_resources/_content.py,sha256=UNHsEIOyNVx5VFtv7n4MeXBxSyAW53vagUHMA5_Udec,19849
 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=4I_b5GFGJUcRNcebCWcM8aDm0DQ6g6Y4JrkpUNxtJSc,16945
+unique_sdk/api_resources/_folder.py,sha256=h7f1NhTlC-pW9uAEMFw78vTpim_ctvRGB5rzcc-L87E,21553
 unique_sdk/api_resources/_group.py,sha256=8A8mSjhWuhFxBA2r_z7q-70miJ_ugz7NAffVwbPu1oo,10302
 unique_sdk/api_resources/_integrated.py,sha256=TxEKSYQZjZezBUk6kUgLvCgqgZXvgZR2IqHLieapKwQ,6204
 unique_sdk/api_resources/_llm_models.py,sha256=3Jn6MpxWgZ43Hze8JHd4_n27si5xmwd3JE8r8cEZq_M,1640
-unique_sdk/api_resources/_mcp.py,sha256=zKh0dyn0QnkKk57N2zlGVN_GQoxEp5T2CS38vVm6jQY,3341
+unique_sdk/api_resources/_mcp.py,sha256=_kWSn4Awvd7vtopbYM3YKhV5-Xrz5h_LBlahmWlKx3U,3384
 unique_sdk/api_resources/_message.py,sha256=wqPH3FdzutHLQXFErAzQYOddoeeE4jEBJr7yrPFYEHo,10986
 unique_sdk/api_resources/_message_assessment.py,sha256=SSfx6eW7zb_GKe8cFJzCqW-t-_eWEXxKP5cnIb0DhIc,2276
 unique_sdk/api_resources/_message_execution.py,sha256=7V_Qovu4vzoXDd2em0AgnAJC460RUX6AE4byztNPlvg,4556
@@ -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=cs5Z3x5vzfJFcxUhVuh2GQSGmP0ygzumwaNPOwJ8upI,9464
+unique_sdk/api_resources/_space.py,sha256=bIeR2IOba2Nzzz4HP15dDEXe50mx7gh9GfatDxwNGXo,14598
 unique_sdk/api_resources/_user.py,sha256=XGlE3SDtv-0qs9boT-ts6F2Cxq8RXAT5OCrvY5nOCx8,4677
 unique_sdk/utils/chat_history.py,sha256=5UqL9hF1O9pV7skbNOlEibF5rHdYsmG3m5-YEPUowOs,3037
 unique_sdk/utils/chat_in_space.py,sha256=mBH4W-Jb8wgGCYV3m12LvoLjTE56xdwUTC-ghMupkSs,5889
 unique_sdk/utils/file_io.py,sha256=z0VdAOtrkU-tMq2v-nogeHtBku3TtnM5eJDHAR6A0-w,5721
 unique_sdk/utils/sources.py,sha256=DoxxhMLcLhmDfNarjXa41H4JD2GSSDywr71hiC-4pYc,4952
 unique_sdk/utils/token.py,sha256=AzKuAA1AwBtnvSFxGcsHLpxXr_wWE5Mj4jYBbOz2ljA,1740
-unique_sdk-0.10.62.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
-unique_sdk-0.10.62.dist-info/METADATA,sha256=zh-NI8rTy0kYmX1B4A_Xs18snScEUnwMHaZXzCeh_v0,11079
-unique_sdk-0.10.62.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_sdk-0.10.62.dist-info/RECORD,,
+unique_sdk-0.10.66.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
+unique_sdk-0.10.66.dist-info/METADATA,sha256=4Zwcojlig85QRkLXRDTVFiUqPk1R1cQZ4sGoc7SwFM0,11458
+unique_sdk-0.10.66.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_sdk-0.10.66.dist-info/RECORD,,