unique_sdk 0.9.31__py3-none-any.whl → 0.9.33__py3-none-any.whl

unique_sdk/api_resources/_content.py

@@ -106,7 +106,7 @@ class Content(APIResource["Content"]):
         ownerId: str
         byteSize: Optional[int]
         ingestionConfig: "Content.IngestionConfig"
-        metadata: dict[str, any] | None = None
+        metadata: dict[str, Any] | None = None
 
     class UpsertParams(RequestOptions):
         input: "Content.Input"
@@ -155,6 +155,32 @@ class Content(APIResource["Content"]):
     chunks: List[Chunk]
     metadata: Optional[Dict[str, Any]]
 
+    class MagicTableSheetTableColumn(TypedDict):
+        columnId: str
+        columnName: str
+        content: str
+
+    class MagicTableSheetTable(TypedDict):
+        rowId: str
+        columns: List["Content.MagicTableSheetTableColumn"]
+    
+    class MagicTableSheetIngestionConfiguration(TypedDict):
+        columnIdsInMetadata: List[str]
+        columnIdsInChunkText: List[str]
+    
+    class MagicTableSheetIngestParams(TypedDict):
+        data: List["Content.MagicTableSheetTable"]
+        ingestionConfiguration: "Content.MagicTableSheetIngestionConfiguration"
+        metadata: Dict[str, Optional[str]]
+        scopeId: str
+
+    class MagicTableSheetRowIdToContentId(TypedDict):
+        rowId: str
+        contentId: str
+
+    class MagicTableSheetResponse(TypedDict):
+        rowIdsToContentIds: List["Content.MagicTableSheetRowIdToContentId"]
+
     @classmethod
     def search(
         cls,
@@ -268,3 +294,39 @@ class Content(APIResource["Content"]):
                 params=params,
             ),
         )
+
+    @classmethod
+    def ingest_magic_table_sheets(
+            cls, 
+            user_id: str, 
+            company_id: str, 
+            **params: Unpack["Content.MagicTableSheetIngestParams"]
+    ) -> "Content.MagicTableSheetResponse":
+        return cast(
+            Content.MagicTableSheetResponse,
+            cls._static_request(
+                "post",
+                "/content/magic-table-sheets",
+                user_id,
+                company_id=company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def ingest_magic_table_sheets_async(
+            cls, 
+            user_id: str, 
+            company_id: str, 
+            **params: Unpack["Content.MagicTableSheetIngestParams"]
+    ) -> "Content.MagicTableSheetResponse":
+        return cast(
+            Content.MagicTableSheetResponse,
+            await cls._static_request_async(
+                "post",
+                "/content/magic-table-sheets",
+                user_id,
+                company_id=company_id,
+                params=params,
+            ),
+        )

unique_sdk/api_resources/_folder.py

@@ -78,6 +78,19 @@ class Folder(APIResource["Folder"]):
     class CreateParams(RequestOptions):
         paths: List[str]
 
+    class FolderInfo(TypedDict):
+        """
+        Represents the information of a folder.
+        """
+
+        id: str
+        name: str
+        ingestionConfig: "Folder.IngestionConfig"
+        createdAt: str | None
+        updatedAt: str | None
+        parentId: str | None
+        externalId: str | None
+
     id: str
     name: str
     scopeAccess: List[ScopeAccess]
@@ -107,6 +120,50 @@ class Folder(APIResource["Folder"]):
         scopeAccesses: List["Folder.ScopeAccess"]
         applyToSubScopes: bool
 
+    class GetParams(RequestOptions):
+        """
+        Parameters for getting a folder by its ID or path.
+        """
+
+        scopeId: str | None = None
+        folderPath: str | None = None
+
+    @classmethod
+    def get_info(
+        cls, user_id: str, company_id: str, **params: Unpack["Folder.GetParams"]
+    ) -> "Folder.FolderInfo":
+        """
+        Get a folder by its ID or path.
+        """
+        return cast(
+            "Folder.FolderInfo",
+            cls._static_request(
+                "get",
+                "/folder/info",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
+    @classmethod
+    async def get_info_async(
+        cls, user_id: str, company_id: str, **params: Unpack["Folder.GetParams"]
+    ) -> "Folder.FolderInfo":
+        """
+        Async get a folder by its ID or path.
+        """
+        return cast(
+            "Folder.FolderInfo",
+            await cls._static_request_async(
+                "get",
+                "/folder/info",
+                user_id,
+                company_id,
+                params=params,
+            ),
+        )
+
     @classmethod
     def create_paths(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.CreateParams"]

unique_sdk/utils/file_io.py

@@ -1,7 +1,7 @@
 import os
 import tempfile
 from pathlib import Path
-from typing import Optional
+from typing import Any, Optional
 
 import requests
 
@@ -41,7 +41,7 @@ def upload_file(
     scope_or_unique_path=None,
     chat_id=None,
     ingestion_config: Optional[Content.IngestionConfig] = None,
-    metadata: dict[str, any] | None = None,
+    metadata: dict[str, Any] | None = None,
 ):
     # check that chatid or scope_or_unique_path is provided
     if not chat_id and not scope_or_unique_path:

{unique_sdk-0.9.31.dist-info → unique_sdk-0.9.33.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.9.31
+Version: 0.9.33
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -434,8 +434,66 @@ def upload_file(
 
 ```
 
+#### `unique_sdk.Content.ingest_magic_table_sheets`
+
+Allows you to ingest a magic table sheet, each row is processed and converted into a content.
+```python
+    params = {
+      "user_id": user_id,
+      "company_id": company_id,
+      "data": [
+         {
+            "rowId": "2",
+            "columns": [
+               {"columnId": "0", "columnName": "Section", "content": "Other"},
+               {"columnId": "1", "columnName": "Question", "content": "What do you know?"},
+               {
+                  "columnId": "2",
+                  "columnName": "Knowledge Base Answer",
+                  "content": "Lorem Ipsum is simply dummy texktop publishing software.",
+               },
+            ],
+         },
+      ],
+      "ingestionConfiguration": {
+         "columnIdsInMetadata": ["1", "2"],
+         "columnIdsInChunkText": ["1", "2"],
+      },
+      "metadata": {
+         "libraryName": "foo",
+      },
+      "scopeId": scope_id,
+   }
+
+    unique_sdk.Content.ingest_magic_table_sheets(**params)
+```
+
 ### Folder
 
+#### `unique_sdk.Folder.get`
+
+Get a folder by scope id or by path.
+
+By scope id:
+
+```python
+unique_sdk.Folder.get_info(
+   user_id=user_id,
+   company_id=company_id,
+   scopeId="scope_w78wfn114va9o22s13r03yq",
+)
+```
+
+By path:
+
+```python
+unique_sdk.Folder.get_info(
+   user_id=user_id,
+   company_id=company_id,
+   folderPath="/Company/Atlas/Due Dilligence/Arch,
+)
+```
+
 #### `unique_sdk.Folder.create_paths`
 
 Create each folder in the provided list of paths if it does not already exist.
@@ -1112,6 +1170,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.9.33] - 2025-06-11
+- Add function to get a folder by id or by path.
+
+## [0.9.32] - 2025-06-11
+- Add function to ingest magic table sheets.
+
 ## [0.9.31] - 2025-05-21
 - Add function to update folder access (add or remove).
 

{unique_sdk-0.9.31.dist-info → unique_sdk-0.9.33.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=hAPPHxoljcoHeTboxoJkcXgpqA2hNBu6a6vamdxag58,2000
-unique_sdk/api_resources/_content.py,sha256=GWCiJMjbiNQFvo8RZ9cnCnTbWMo4NiUxLx-WgTzssc4,7589
+unique_sdk/api_resources/_content.py,sha256=BLv4qXdazSYy_L0Z9ihr0hquE3xFIY32CBpfbOkxSpE,9527
 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=E-v4JAixhtYsOZXbEOTO8gyykPzPr62MraoPPy01vn8,6900
+unique_sdk/api_resources/_folder.py,sha256=RYX7gQarTwu3Q-UD8YQdW0DQo3uU3Zwzl_nM-IINYJM,8360
 unique_sdk/api_resources/_integrated.py,sha256=l1vS8kJiSLie61mqDO3KI2MNmYwFydmCIoJpP_tPhSI,2956
 unique_sdk/api_resources/_message.py,sha256=gEDIzg3METZU2k7m69meAuf0IWmZxnYOjbBKPRMwPYE,7688
 unique_sdk/api_resources/_message_assessment.py,sha256=SSfx6eW7zb_GKe8cFJzCqW-t-_eWEXxKP5cnIb0DhIc,2276
@@ -27,10 +27,10 @@ unique_sdk/api_resources/_search.py,sha256=pAVMXL2AdJNP5JG-7LlaU2Uw1152iUaMZ2YO7
 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
 unique_sdk/utils/chat_history.py,sha256=5UqL9hF1O9pV7skbNOlEibF5rHdYsmG3m5-YEPUowOs,3037
-unique_sdk/utils/file_io.py,sha256=jR1sj1SxOvqmCoLfYkevgTktcTZId0ORoqYjmwVoyJw,4301
+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.9.31.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
-unique_sdk-0.9.31.dist-info/METADATA,sha256=v0jkEyJg5EwdcPDFfkyjKuAKBDEpiaMDJ6jkmrQ2j2g,35598
-unique_sdk-0.9.31.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-unique_sdk-0.9.31.dist-info/RECORD,,
+unique_sdk-0.9.33.dist-info/LICENSE,sha256=EJCWoHgrXVBUb47PnjeV4MFIEOR71MAdCOIgv61J-4k,1065
+unique_sdk-0.9.33.dist-info/METADATA,sha256=V5_YPqBgfe0HcpWQokIZMmiK2WbHJtmoWvvH8TzGkks,37133
+unique_sdk-0.9.33.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+unique_sdk-0.9.33.dist-info/RECORD,,