unique_sdk 0.10.4__py3-none-any.whl → 0.10.5__py3-none-any.whl

unique_sdk/api_resources/_content.py

@@ -73,8 +73,8 @@ class Content(APIResource["Content"]):
         """
 
         metadataFilter: dict
-        skip: int | None
-        take: int | None
+        skip: NotRequired[int]
+        take: NotRequired[int]
 
     class CustomApiOptions(TypedDict):
         apiIdentifier: str
@@ -145,7 +145,7 @@ class Content(APIResource["Content"]):
         expiredAt: str | None
 
     class PaginatedContentInfo(TypedDict):
-        contentInfo: List["Content.ContentInfo"]
+        contentInfos: List["Content.ContentInfo"]
         totalCount: int
 
     id: str
@@ -230,7 +230,7 @@ class Content(APIResource["Content"]):
             Content.PaginatedContentInfo,
             cls._static_request(
                 "post",
-                "/content/info",
+                "/content/infos",
                 user_id,
                 company_id,
                 params=params,
@@ -248,7 +248,43 @@ class Content(APIResource["Content"]):
             Content.PaginatedContentInfo,
             await cls._static_request_async(
                 "post",
-                "/content/info",
+                "/content/infos",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    def get_infos(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Content.ContentInfoParams"],
+    ) -> "Content.PaginatedContentInfo":
+        return cast(
+            Content.PaginatedContentInfo,
+            cls._static_request(
+                "post",
+                "/content/infos",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def get_infos_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Content.ContentInfoParams"],
+    ) -> "Content.PaginatedContentInfo":
+        return cast(
+            Content.PaginatedContentInfo,
+            await cls._static_request_async(
+                "post",
+                "/content/infos",
                 user_id,
                 company_id,
                 params=params,

unique_sdk/api_resources/_folder.py

@@ -1,5 +1,14 @@
 from enum import Enum
-from typing import ClassVar, List, Literal, Optional, TypedDict, Unpack, cast
+from typing import (
+    ClassVar,
+    List,
+    Literal,
+    NotRequired,
+    Optional,
+    TypedDict,
+    Unpack,
+    cast,
+)
 
 from unique_sdk._api_resource import APIResource
 from unique_sdk._request_options import RequestOptions
@@ -128,12 +137,21 @@ class Folder(APIResource["Folder"]):
 
     class GetParams(RequestOptions):
         """
-        Parameters for getting a folder by its ID or path.
+        Parameters for getting a folder by its Id or path.
         """
 
         scopeId: str | None = None
         folderPath: str | None = None
 
+    class GetInfosParams(RequestOptions):
+        """
+        Parameters for getting multiple paginated folders by their parent Id.
+        """
+
+        parentId: NotRequired[str]
+        take: NotRequired[int]
+        skip: NotRequired[int]
+
     @classmethod
     def get_info(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.GetParams"]
@@ -170,6 +188,42 @@ class Folder(APIResource["Folder"]):
             ),
         )
 
+    @classmethod
+    def get_infos(
+        cls, user_id: str, company_id: str, **params: Unpack["Folder.GetInfosParams"]
+    ) -> "List[Folder.FolderInfo]":
+        """
+        Get paginated folders based on parentId. If the parentId is not defined, the root folders will be returned.
+        """
+        return cast(
+            "List[Folder.FolderInfo]",
+            cls._static_request(
+                "get",
+                "/folder/infos",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def get_infos_async(
+        cls, user_id: str, company_id: str, **params: Unpack["Folder.GetInfosParams"]
+    ) -> "List[Folder.FolderInfo]":
+        """
+        Async get paginated folders based on parentId. If the parentId is not defined, the root folders will be returned.
+        """
+        return cast(
+            "List[Folder.FolderInfo]",
+            await cls._static_request_async(
+                "get",
+                "/folder/infos",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
     @classmethod
     def create_paths(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.CreateParams"]

{unique_sdk-0.10.4.dist-info → unique_sdk-0.10.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.4
+Version: 0.10.5
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -294,7 +294,7 @@ unique_sdk.Content.search(
 
 #### `unique_sdk.Content.get_info`
 
-Allows you to get content info. To filter the results you can define a metadata filter in UniqueQL language. Find out more about it in the UniqueQL section. An example of a metadata filter defined with UniqueQL is the following:
+[Deprecated, use `unique_sdk.Content.get_infos` instead.] Allows you to get content info. To filter the results you can define a metadata filter in UniqueQL language. Find out more about it in the UniqueQL section. An example of a metadata filter defined with UniqueQL is the following:
 
 ```python
     metadataFilter: {
@@ -326,7 +326,7 @@ Pagination is also enabled for this functionality, and the default number of ret
 - `skip`
 - `take`
 
-Here is an example of retrieving the first 3 content infos that contain the value `uniquepathid://scope_abcdibgznc4bkdcx120zm5d` in the `folderIdPath` metadata and the value `ai` for the `tile` metadata.
+Here is an example of retrieving the first 3 content infos that contain the value `uniquepathid://scope_abcdibgznc4bkdcx120zm5d` in the `folderIdPath` metadata and the value `ai` for the `title` metadata.
 
 ```python
 content_info_result = unique_sdk.Content.get_info(
@@ -359,6 +359,85 @@ content_info_result = unique_sdk.Content.get_info(
 )
 ```
 
+#### `unique_sdk.Content.get_infos`
+
+Allows you to get content infos. To filter the results you can define a either metadata filter in UniqueQL language or specify a parentId. If both are defined, the function will throw an error.
+
+I f you want to learn more about UniqueQL, you can find out more about it in the [UniqueQL](#uniqueql) section. An example of a metadata filter defined with UniqueQL is the following:
+
+```python
+    metadataFilter: {
+        "or": [
+            {
+                "and": [
+                    {
+                        "operator": "contains",
+                        "path": [
+                            "folderIdPath"
+                        ],
+                        "value": "uniquepathid://test_id"
+                    },
+                    {
+                        "operator": "contains",
+                        "path": [
+                            "title"
+                        ],
+                        "value": "ai"
+                    }
+                ]
+            }
+        ]
+    },
+```
+
+Pagination is also enabled for this functionality, and the default number of returned results is 50 with no entries skipped. Use the following paramteres to get the desired page:`
+
+- `skip`
+- `take`
+
+Here is an example of retrieving the first 3 content infos that contain the value `uniquepathid://scope_abcdibgznc4bkdcx120zm5d` in the `folderIdPath` metadata and the value `ai` for the `title` metadata.
+
+```python
+content_info_result = unique_sdk.Content.get_infos(
+    user_id=user_id,
+    company_id=company_id,
+    metadataFilter={
+        "or": [
+            {
+                "and": [
+                    {
+                        "operator": "contains",
+                        "path": [
+                            "folderIdPath"
+                        ],
+                        "value": "uniquepathid://scope_abcdibgznc4bkdcx120zm5d"
+                    },
+                    {
+                        "operator": "contains",
+                        "path": [
+                            "title"
+                        ],
+                        "value": "ai"
+                    }
+                ]
+            }
+        ]
+    },
+    skip=0,
+    take=3,
+)
+```
+
+Here is an example of retrieving the contents based on a parentId.
+
+```python
+content_info_result = unique_sdk.Content.get_infos(
+    user_id=user_id,
+    company_id=company_id,
+    parentId="scope_ahefgj389srjbfejkkk98u"
+)
+```
+
 #### `unique_sdk.Content.upsert`
 
 Enables upload of a new Content into the Knowledge base of unique into a specific scope with `scopeId` or a specific `chatId`. One of the two must be set.
@@ -820,7 +899,7 @@ assessment = unique_sdk.MessageAssessment.modify(
 
 ### Folder
 
-#### `unique_sdk.Folder.get`
+#### `unique_sdk.Folder.get_info`
 
 Get a folder by scope id or by path.
 
@@ -844,6 +923,20 @@ unique_sdk.Folder.get_info(
 )
 ```
 
+#### `unique_sdl.Folder.get_infos`
+
+Get paginated folders info based on parentId. If the parentId is not defined, the root folders will be returned.
+
+```python
+unique_sdk.Folder.get_infos(
+    user_id=user_id,
+    company_id=company_id,
+    take=10,                                    #optional
+    skip=5,                                     #optional
+    parentId="scope_s18seqpnltf35niydg77xgyp"   #optional
+)
+```
+
 #### `unique_sdk.Folder.create_paths`
 
 Create each folder in the provided list of paths if it does not already exist.
@@ -1371,6 +1464,9 @@ 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.5] - 2025-08-06
+- Get paginated files and folders info.
+
 ## [0.10.4] - 2025-08-05
 - Add support for reasoning API with streaming within a chat.
 

{unique_sdk-0.10.4.dist-info → unique_sdk-0.10.5.dist-info}/RECORD

@@ -16,10 +16,10 @@ unique_sdk/_webhook.py,sha256=GYxbUibQN_W4XlNTHaMIksT9FQJk4LJmlKcxOu3jqiU,2855
 unique_sdk/api_resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_sdk/api_resources/_acronyms.py,sha256=GIU1XH1flGWQYcpsFqTYwg4ioIGxVmb15tux84nmhEg,891
 unique_sdk/api_resources/_chat_completion.py,sha256=ILCAffxkbkfh2iV9L4KKnfe80gZmT9pWfkNmf3mq68U,2172
-unique_sdk/api_resources/_content.py,sha256=Rl1Pb0vUQ9EkEQa0XTGOLZamAYlZaz7h6jNWE-zqFaw,9554
+unique_sdk/api_resources/_content.py,sha256=Z7fyydfUzN56htj8_PXBBATyjX58tlVekvyUnj5yAHo,10505
 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=dmPorUoOJSe-hcxlJq3RnkQeZg3gPqGF37ZsLgnloT0,8335
+unique_sdk/api_resources/_folder.py,sha256=rDO3rHNddvVWBhM4gaut9WN1A_hASJHiFiAS6a8MszU,9772
 unique_sdk/api_resources/_integrated.py,sha256=z_DrftwjgVCi10QQqRYnG5_-95kD7Kfjogbb-dmnJuA,5854
 unique_sdk/api_resources/_mcp.py,sha256=jBHf89LrjdYKoMeKJHyzKWih870VvXvGIl7hpf8dGIU,3353
 unique_sdk/api_resources/_message.py,sha256=gEDIzg3METZU2k7m69meAuf0IWmZxnYOjbBKPRMwPYE,7688
@@ -33,7 +33,7 @@ unique_sdk/utils/chat_in_space.py,sha256=nYmgQYhIxqQex_6zjdCfNuGnjoU14WkxUN6_zmS
 unique_sdk/utils/file_io.py,sha256=YY8B7VJcTLOPmCXByiOfNerXGlAtjCC5EVNmAbQJ3dQ,4306
 unique_sdk/utils/sources.py,sha256=wfboE-neMKa0Wuq9QzfAEFMkNLrIrmm0v-QF33sLo6k,4952
 unique_sdk/utils/token.py,sha256=AzKuAA1AwBtnvSFxGcsHLpxXr_wWE5Mj4jYBbOz2ljA,1740
-unique_sdk-0.10.4.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
-unique_sdk-0.10.4.dist-info/METADATA,sha256=YMsJPKoqFCTfjAyP9d3xtJWHuTUq7r-JIRaB0mEhwI0,46007
-unique_sdk-0.10.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_sdk-0.10.4.dist-info/RECORD,,
+unique_sdk-0.10.5.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
+unique_sdk-0.10.5.dist-info/METADATA,sha256=1bVLFeyqncNXAgxnnbY9P-oShXFuzED4cWPPwEadTNo,49000
+unique_sdk-0.10.5.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_sdk-0.10.5.dist-info/RECORD,,