unique_sdk 0.10.32__tar.gz → 0.10.38__tar.gz

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/CHANGELOG.md

@@ -5,6 +5,24 @@ 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.38] - 2025-11-06
+- Add description property to Reference and Content.
+
+## [0.10.37] - 2025-11-04
+- Introduce local integration tests for Content API Resource
+
+## [0.10.36] - 2025-11-04
+- Introduce local integration tests for Folder API Resource
+
+## [0.10.35] - 2025-11-04
+- Inmprove folder get infos types.
+
+## [0.10.34] - 2025-10-29
+- Add documentation for agentic table.
+
+## [0.10.33] - 2025-10-27
+- Improve messagelog and message execution types.
+
 ## [0.10.32] - 2025-10-14
 - Add function to stream to chat frontend.
 

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.32
+Version: 0.10.38
 Summary: 
 License: MIT
 Author: Martin Fadler
@@ -42,6 +42,7 @@ The Unique Python SDK provides access to the public API of Unique AI. It also en
    - [Message Assessment](#message-assessment)
    - [Folder](#folder)
    - [Space](#space)
+   - [Agentic Table](#agentic-table)
 6. [UniqueQL](#uniqueql)
    - [Query Structure](#uniqueql-query-structure)
    - [Metadata Filtering](#metadata-filtering)
@@ -259,6 +260,7 @@ unique_sdk.Message.modify(
 - [Message Assessment](#message-assessment)
 - [Folder](#folder)
 - [Space](#space)
+- [Agentic Table](#agentic-table)
 
 Most of the API services provide an asynchronous version of the method. The async methods are suffixed with `_async`.
 
@@ -475,6 +477,7 @@ def upload_file(
     path_to_file,
     displayed_filename,
     mimeType,
+    description=None,
     scope_or_unique_path,
     ingestion_config=None,
     metadata=None,
@@ -487,6 +490,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
         },
@@ -513,6 +517,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "byteSize": size,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
@@ -890,10 +895,7 @@ msg_execution = unique_sdk.MessageExecution.create(
     user_id=user_id,
     company_id=company_id,
     messageId="msg_a0jgnt1jrqv143uzr750waxw",
-    chatId="chat_nx21havszl1skchd7544oykh",
     type="DEEP_RESEARCH",
-    secondsRemaining=None,                       # optional, number defining the seconds remaining
-    percentageCompleted=None,                    # optional, number defining the percentage completed
 )
 ```
 
@@ -918,7 +920,7 @@ msg_execution = unique_sdk.MessageExecution.update(
     user_id=user_id,
     company_id=company_id,
     messageId="msg_a0jgnt1jrqv143uzr750waxw",
-    status="COMPLETED",                        # one of: COMPLETED, FAILED
+    status="COMPLETED",                        # optional, one of: COMPLETED, FAILED - not specifying the status will have no effect over the status
     secondsRemaining=55,                       # optional, number defining the seconds remaining
     percentageCompleted=10,                    # optional, number defining the percentage completed
 )
@@ -1372,6 +1374,214 @@ unique_sdk.Space.delete_chat(
 )
 ```
 
+### Agentic Table
+
+The Agentic Table (Magic Table) API provides functionality for managing interactive tables with AI-powered cells, activity tracking, and metadata management.
+
+#### `unique_sdk.AgenticTable.set_cell`
+
+Set the content of a specific cell in the magic table. This method allows you to update cell text and optionally add log entries to track changes.
+
+```python
+cell = await unique_sdk.AgenticTable.set_cell(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrder=0,
+    columnOrder=1,
+    text="Updated cell content",
+    logEntries=[  # optional
+        {
+            "text": "Cell updated by automation",
+            "createdAt": "2024-01-01T00:00:00.000Z",
+            "actorType": "SYSTEM",  # One of: "USER", "SYSTEM", "ASSISTANT", "TOOL"
+            "messageId": "msg_123",  # optional
+            "details": [  # optional
+                {
+                    "text": "Processing completed",
+                    "messageId": "msg_456"  # optional
+                }
+            ]
+        }
+    ]
+)
+```
+
+#### `unique_sdk.AgenticTable.get_cell`
+
+Retrieve the content and metadata of a specific cell.
+
+```python
+cell = await unique_sdk.AgenticTable.get_cell(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrder=0,
+    columnOrder=1,
+)
+```
+
+#### `unique_sdk.AgenticTable.set_multiple_cells`
+
+Bulk update multiple cells in a single operation for better performance.
+
+```python
+result = await unique_sdk.AgenticTable.set_multiple_cells(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    cells=[
+        {
+            "rowOrder": 0,
+            "columnOrder": 0,
+            "text": "Cell A1"
+        },
+        {
+            "rowOrder": 0,
+            "columnOrder": 1,
+            "text": "Cell B1"
+        },
+        {
+            "rowOrder": 1,
+            "columnOrder": 0,
+            "text": "Cell A2"
+        }
+    ]
+)
+```
+
+#### `unique_sdk.AgenticTable.get_sheet_data`
+
+Retrieve comprehensive data about a magic table sheet, including cells, log history, and metadata.
+
+```python
+sheet = await unique_sdk.AgenticTable.get_sheet_data(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    includeCells=True,             # optional
+    includeLogHistory=True,        # optional
+    includeRowCount=True,          # optional
+    includeCellMetaData=True,      # optional
+    startRow=0,                    # optional: specify row range
+    endRow=10                      # optional: specify row range
+)
+```
+
+#### `unique_sdk.AgenticTable.get_sheet_state`
+
+Get the current state of a magic table sheet.
+
+```python
+state = await unique_sdk.AgenticTable.get_sheet_state(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123"
+)
+# Returns: "PROCESSING", "IDLE", or "STOPPED_BY_USER"
+```
+
+#### `unique_sdk.AgenticTable.update_sheet_state`
+
+Update the name or state of a magic table sheet.
+
+```python
+result = await unique_sdk.AgenticTable.update_sheet_state(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    name="Updated Sheet Name",  # optional
+    state="IDLE"  # optional, one of: "PROCESSING", "IDLE", "STOPPED_BY_USER"
+)
+```
+
+#### `unique_sdk.AgenticTable.set_activity`
+
+Set the status of an activity on the magic table sheet. This is useful for tracking long-running operations.
+
+```python
+result = await unique_sdk.AgenticTable.set_activity(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    activity="UpdateCell",
+    # activity: one of "DeleteRow", "DeleteColumn", "UpdateCell", "AddQuestionText", 
+    # "AddMetaData", "GenerateArtifact", "SheetCompleted", "LibrarySheetRowVerified"
+    status="IN_PROGRESS",
+    # status: one of "IN_PROGRESS", "COMPLETED", "FAILED"
+    text="Updating cells with AI-generated content"
+)
+```
+
+#### `unique_sdk.AgenticTable.set_artifact`
+
+Attach an artifact (such as a generated document) to the magic table sheet.
+
+```python
+result = await unique_sdk.AgenticTable.set_artifact(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    name="Generated Report",
+    contentId="cont_xyz789",
+    mimeType="application/pdf",
+    artifactType="FULL_REPORT"  # One of: "QUESTIONS", "FULL_REPORT"
+)
+```
+
+#### `unique_sdk.AgenticTable.set_column_metadata`
+
+Configure metadata for a specific column, including width, filters, and cell renderers.
+
+```python
+result = await unique_sdk.AgenticTable.set_column_metadata(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    columnOrder=2,
+    columnWidth=200,  # optional
+    filter="ValueMatchFilter",  # optional
+    # filter: one of "ValueMatchFilter", "PartialMatchFilter", "ReferenceFilter", 
+    # "HallucinationFilter", "ReviewStatusFilter", "AssigneeFilter"
+    cellRenderer="CheckboxLockCellRenderer",  # optional
+    # cellRenderer: one of "CheckboxLockCellRenderer", "CollaboratorDropdown", 
+    # "ReviewStatusDropdown", "CustomCellRenderer", "SelectableCellRenderer"
+    editable=True  # optional
+)
+```
+
+#### `unique_sdk.AgenticTable.set_cell_metadata`
+
+Set metadata for a specific cell, including selection status and agreement status.
+
+```python
+result = await unique_sdk.AgenticTable.set_cell_metadata(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrder=0,
+    columnOrder=1,
+    selected=True,                # optional
+    selectionMethod="MANUAL",     # optional, one of: "DEFAULT", "MANUAL"
+    agreementStatus="MATCH"       # optional, one of: "MATCH", "NO_MATCH"
+)
+```
+
+#### `unique_sdk.AgenticTable.bulk_update_status`
+
+Update the verification status of multiple rows at once.
+
+```python
+result = await unique_sdk.AgenticTable.bulk_update_status(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrders=[0, 1, 2, 3, 4],
+    status="VERIFIED"
+    # status: one of "NEED_REVIEW", "READY_FOR_VERIFICATION", "VERIFIED"
+)
+```
+
 ## UniqueQL
 
 [UniqueQL](https://unique-ch.atlassian.net/wiki/x/coAXHQ) is an advanced query language designed to enhance search capabilities within various search modes such as Vector, Full-Text Search (FTS), and Combined. This query language enables users to perform detailed searches by filtering through metadata attributes like filenames, URLs, dates, and more. UniqueQL is versatile and can be translated into different query formats for various database systems, including PostgreSQL and Qdrant.
@@ -1769,6 +1979,24 @@ 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.38] - 2025-11-06
+- Add description property to Reference and Content.
+
+## [0.10.37] - 2025-11-04
+- Introduce local integration tests for Content API Resource
+
+## [0.10.36] - 2025-11-04
+- Introduce local integration tests for Folder API Resource
+
+## [0.10.35] - 2025-11-04
+- Inmprove folder get infos types.
+
+## [0.10.34] - 2025-10-29
+- Add documentation for agentic table.
+
+## [0.10.33] - 2025-10-27
+- Improve messagelog and message execution types.
+
 ## [0.10.32] - 2025-10-14
 - Add function to stream to chat frontend.
 

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/README.md

@@ -24,6 +24,7 @@ The Unique Python SDK provides access to the public API of Unique AI. It also en
    - [Message Assessment](#message-assessment)
    - [Folder](#folder)
    - [Space](#space)
+   - [Agentic Table](#agentic-table)
 6. [UniqueQL](#uniqueql)
    - [Query Structure](#uniqueql-query-structure)
    - [Metadata Filtering](#metadata-filtering)
@@ -241,6 +242,7 @@ unique_sdk.Message.modify(
 - [Message Assessment](#message-assessment)
 - [Folder](#folder)
 - [Space](#space)
+- [Agentic Table](#agentic-table)
 
 Most of the API services provide an asynchronous version of the method. The async methods are suffixed with `_async`.
 
@@ -457,6 +459,7 @@ def upload_file(
     path_to_file,
     displayed_filename,
     mimeType,
+    description=None,
     scope_or_unique_path,
     ingestion_config=None,
     metadata=None,
@@ -469,6 +472,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
         },
@@ -495,6 +499,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mimeType,
+            "description": description,
             "byteSize": size,
             "ingestionConfig": ingestionConfig,
             "metadata": metadata,
@@ -872,10 +877,7 @@ msg_execution = unique_sdk.MessageExecution.create(
     user_id=user_id,
     company_id=company_id,
     messageId="msg_a0jgnt1jrqv143uzr750waxw",
-    chatId="chat_nx21havszl1skchd7544oykh",
     type="DEEP_RESEARCH",
-    secondsRemaining=None,                       # optional, number defining the seconds remaining
-    percentageCompleted=None,                    # optional, number defining the percentage completed
 )
 ```
 
@@ -900,7 +902,7 @@ msg_execution = unique_sdk.MessageExecution.update(
     user_id=user_id,
     company_id=company_id,
     messageId="msg_a0jgnt1jrqv143uzr750waxw",
-    status="COMPLETED",                        # one of: COMPLETED, FAILED
+    status="COMPLETED",                        # optional, one of: COMPLETED, FAILED - not specifying the status will have no effect over the status
     secondsRemaining=55,                       # optional, number defining the seconds remaining
     percentageCompleted=10,                    # optional, number defining the percentage completed
 )
@@ -1354,6 +1356,214 @@ unique_sdk.Space.delete_chat(
 )
 ```
 
+### Agentic Table
+
+The Agentic Table (Magic Table) API provides functionality for managing interactive tables with AI-powered cells, activity tracking, and metadata management.
+
+#### `unique_sdk.AgenticTable.set_cell`
+
+Set the content of a specific cell in the magic table. This method allows you to update cell text and optionally add log entries to track changes.
+
+```python
+cell = await unique_sdk.AgenticTable.set_cell(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrder=0,
+    columnOrder=1,
+    text="Updated cell content",
+    logEntries=[  # optional
+        {
+            "text": "Cell updated by automation",
+            "createdAt": "2024-01-01T00:00:00.000Z",
+            "actorType": "SYSTEM",  # One of: "USER", "SYSTEM", "ASSISTANT", "TOOL"
+            "messageId": "msg_123",  # optional
+            "details": [  # optional
+                {
+                    "text": "Processing completed",
+                    "messageId": "msg_456"  # optional
+                }
+            ]
+        }
+    ]
+)
+```
+
+#### `unique_sdk.AgenticTable.get_cell`
+
+Retrieve the content and metadata of a specific cell.
+
+```python
+cell = await unique_sdk.AgenticTable.get_cell(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrder=0,
+    columnOrder=1,
+)
+```
+
+#### `unique_sdk.AgenticTable.set_multiple_cells`
+
+Bulk update multiple cells in a single operation for better performance.
+
+```python
+result = await unique_sdk.AgenticTable.set_multiple_cells(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    cells=[
+        {
+            "rowOrder": 0,
+            "columnOrder": 0,
+            "text": "Cell A1"
+        },
+        {
+            "rowOrder": 0,
+            "columnOrder": 1,
+            "text": "Cell B1"
+        },
+        {
+            "rowOrder": 1,
+            "columnOrder": 0,
+            "text": "Cell A2"
+        }
+    ]
+)
+```
+
+#### `unique_sdk.AgenticTable.get_sheet_data`
+
+Retrieve comprehensive data about a magic table sheet, including cells, log history, and metadata.
+
+```python
+sheet = await unique_sdk.AgenticTable.get_sheet_data(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    includeCells=True,             # optional
+    includeLogHistory=True,        # optional
+    includeRowCount=True,          # optional
+    includeCellMetaData=True,      # optional
+    startRow=0,                    # optional: specify row range
+    endRow=10                      # optional: specify row range
+)
+```
+
+#### `unique_sdk.AgenticTable.get_sheet_state`
+
+Get the current state of a magic table sheet.
+
+```python
+state = await unique_sdk.AgenticTable.get_sheet_state(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123"
+)
+# Returns: "PROCESSING", "IDLE", or "STOPPED_BY_USER"
+```
+
+#### `unique_sdk.AgenticTable.update_sheet_state`
+
+Update the name or state of a magic table sheet.
+
+```python
+result = await unique_sdk.AgenticTable.update_sheet_state(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    name="Updated Sheet Name",  # optional
+    state="IDLE"  # optional, one of: "PROCESSING", "IDLE", "STOPPED_BY_USER"
+)
+```
+
+#### `unique_sdk.AgenticTable.set_activity`
+
+Set the status of an activity on the magic table sheet. This is useful for tracking long-running operations.
+
+```python
+result = await unique_sdk.AgenticTable.set_activity(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    activity="UpdateCell",
+    # activity: one of "DeleteRow", "DeleteColumn", "UpdateCell", "AddQuestionText", 
+    # "AddMetaData", "GenerateArtifact", "SheetCompleted", "LibrarySheetRowVerified"
+    status="IN_PROGRESS",
+    # status: one of "IN_PROGRESS", "COMPLETED", "FAILED"
+    text="Updating cells with AI-generated content"
+)
+```
+
+#### `unique_sdk.AgenticTable.set_artifact`
+
+Attach an artifact (such as a generated document) to the magic table sheet.
+
+```python
+result = await unique_sdk.AgenticTable.set_artifact(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    name="Generated Report",
+    contentId="cont_xyz789",
+    mimeType="application/pdf",
+    artifactType="FULL_REPORT"  # One of: "QUESTIONS", "FULL_REPORT"
+)
+```
+
+#### `unique_sdk.AgenticTable.set_column_metadata`
+
+Configure metadata for a specific column, including width, filters, and cell renderers.
+
+```python
+result = await unique_sdk.AgenticTable.set_column_metadata(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    columnOrder=2,
+    columnWidth=200,  # optional
+    filter="ValueMatchFilter",  # optional
+    # filter: one of "ValueMatchFilter", "PartialMatchFilter", "ReferenceFilter", 
+    # "HallucinationFilter", "ReviewStatusFilter", "AssigneeFilter"
+    cellRenderer="CheckboxLockCellRenderer",  # optional
+    # cellRenderer: one of "CheckboxLockCellRenderer", "CollaboratorDropdown", 
+    # "ReviewStatusDropdown", "CustomCellRenderer", "SelectableCellRenderer"
+    editable=True  # optional
+)
+```
+
+#### `unique_sdk.AgenticTable.set_cell_metadata`
+
+Set metadata for a specific cell, including selection status and agreement status.
+
+```python
+result = await unique_sdk.AgenticTable.set_cell_metadata(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrder=0,
+    columnOrder=1,
+    selected=True,                # optional
+    selectionMethod="MANUAL",     # optional, one of: "DEFAULT", "MANUAL"
+    agreementStatus="MATCH"       # optional, one of: "MATCH", "NO_MATCH"
+)
+```
+
+#### `unique_sdk.AgenticTable.bulk_update_status`
+
+Update the verification status of multiple rows at once.
+
+```python
+result = await unique_sdk.AgenticTable.bulk_update_status(
+    user_id=user_id,
+    company_id=company_id,
+    tableId="sheet_abc123",
+    rowOrders=[0, 1, 2, 3, 4],
+    status="VERIFIED"
+    # status: one of "NEED_REVIEW", "READY_FOR_VERIFICATION", "VERIFIED"
+)
+```
+
 ## UniqueQL
 
 [UniqueQL](https://unique-ch.atlassian.net/wiki/x/coAXHQ) is an advanced query language designed to enhance search capabilities within various search modes such as Vector, Full-Text Search (FTS), and Combined. This query language enables users to perform detailed searches by filtering through metadata attributes like filenames, URLs, dates, and more. UniqueQL is versatile and can be translated into different query formats for various database systems, including PostgreSQL and Qdrant.

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_sdk"
-version = "0.10.32"
+version = "0.10.38"
 description = ""
 authors = [
     "Martin Fadler <martin.fadler@unique.ch>",
@@ -28,6 +28,8 @@ pyright = "^1.1.341"
 pytest-cov = "^4.1.0"
 pytest-asyncio = "^0.24.0"
 python-dotenv = "^1.1.0"
+httpx = "^0.28.1"
+ipykernel = "^7.1.0"
 
 [tool.poetry.extras]
 openai = ["openai"]

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/api_resources/_content.py

@@ -20,6 +20,16 @@ from unique_sdk._request_options import RequestOptions
 class Content(APIResource["Content"]):
     OBJECT_NAME: ClassVar[Literal["content.search"]] = "content.search"
 
+    id: str
+    key: str
+    url: Optional[str]
+    title: Optional[str]
+    updatedAt: str
+    chunks: Optional[List["Content.Chunk"]]
+    metadata: Optional[Dict[str, Any]]
+    writeUrl: Optional[str]
+    readUrl: Optional[str]
+
     class QueryMode(Enum):
         Default = "default"
         Insensitive = "insensitive"
@@ -127,6 +137,7 @@ class Content(APIResource["Content"]):
         key: str
         title: Optional[str]
         mimeType: str
+        description: NotRequired[str | None]
         ownerType: NotRequired[str | None]
         ownerId: NotRequired[str | None]
         byteSize: NotRequired[int | None]
@@ -168,6 +179,7 @@ class Content(APIResource["Content"]):
         title: str | None
         metadata: Dict[str, Any] | None
         mimeType: str
+        description: str | None
         byteSize: int
         ownerId: str
         createdAt: str
@@ -192,16 +204,6 @@ class Content(APIResource["Content"]):
     class DeleteResponse(TypedDict):
         id: str
 
-    id: str
-    key: str
-    url: Optional[str]
-    title: Optional[str]
-    updatedAt: str
-    chunks: List[Chunk]
-    metadata: Optional[Dict[str, Any]]
-    writeUrl: str
-    readUrl: str
-
     class MagicTableSheetTableColumn(TypedDict):
         columnId: str
         columnName: str

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/api_resources/_folder.py

@@ -83,6 +83,10 @@ class Folder(APIResource["Folder"]):
         parentId: str | None
         externalId: str | None
 
+    class FolderInfos(TypedDict):
+        folderInfos: List["Folder.FolderInfo"]
+        totalCount: int
+
     id: str
     name: str
     scopeAccess: List[ScopeAccess]
@@ -212,12 +216,12 @@ class Folder(APIResource["Folder"]):
     @classmethod
     def get_infos(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.GetInfosParams"]
-    ) -> "List[Folder.FolderInfo]":
+    ) -> "Folder.FolderInfos":
         """
         Get paginated folders based on parentId. If the parentId is not defined, the root folders will be returned.
         """
         return cast(
-            "List[Folder.FolderInfo]",
+            "Folder.FolderInfos",
             cls._static_request(
                 "get",
                 "/folder/infos",
@@ -230,12 +234,12 @@ class Folder(APIResource["Folder"]):
     @classmethod
     async def get_infos_async(
         cls, user_id: str, company_id: str, **params: Unpack["Folder.GetInfosParams"]
-    ) -> "List[Folder.FolderInfo]":
+    ) -> "Folder.FolderInfos":
         """
         Async get paginated folders based on parentId. If the parentId is not defined, the root folders will be returned.
         """
         return cast(
-            "List[Folder.FolderInfo]",
+            "Folder.FolderInfos",
             await cls._static_request_async(
                 "get",
                 "/folder/infos",

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/api_resources/_message.py

@@ -29,8 +29,10 @@ class Message(APIResource["Message"]):
 
     class Reference(TypedDict):
         name: str
+        description: Optional[str]
         url: Optional[str]
         sequenceNumber: int
+        originalIndex: Optional[list[int]]
         sourceId: str
         source: str
 

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/api_resources/_message_execution.py

@@ -8,16 +8,18 @@ class MessageExecution(APIResource["MessageExecution"]):
     OBJECT_NAME: ClassVar[Literal["message_execution"]] = "message_execution"
     RESOURCE_URL = "/message-execution"
 
+    TypeLiteral = Literal["DEEP_RESEARCH"]
+    StatusLiteral = Literal["PENDING", "RUNNING", "COMPLETED", "FAILED"]
+    # Only COMPLETED and FAILED statuses are allowed for update
+    UpdateStatusLiteral = Literal["COMPLETED", "FAILED"]
+
     class CreateMessageExecutionParams(RequestOptions):
         """
         Parameters for creating a message execution.
         """
 
         messageId: str
-        chatId: str
-        type: Literal["DEEP_RESEARCH"]
-        secondsRemaining: NotRequired[int | None]
-        percentageCompleted: NotRequired[int | None]
+        type: "MessageExecution.TypeLiteral"
 
     class GetMessageExecutionParams(RequestOptions):
         """
@@ -32,18 +34,19 @@ class MessageExecution(APIResource["MessageExecution"]):
         """
 
         messageId: str
-        status: Literal["COMPLETED", "FAILED"]
+        status: NotRequired["MessageExecution.UpdateStatusLiteral | None"]
         secondsRemaining: NotRequired[int | None]
         percentageCompleted: NotRequired[int | None]
 
-    messageExecutionId: str | None
-    messageId: str | None
-    status: Literal["PENDING", "RUNNING", "COMPLETED", "FAILED"]
-    type: Literal["DEEP_RESEARCH"] = "DEEP_RESEARCH"
+    id: str
+    messageId: str
+    status: "MessageExecution.StatusLiteral"
+    type: "MessageExecution.TypeLiteral"
     secondsRemaining: int | None
     percentageCompleted: int | None
+    positionInQueue: int | None
     createdAt: str
-    updatedAt: str | None
+    updatedAt: str
 
     @classmethod
     def create(

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/api_resources/_message_log.py

@@ -1,4 +1,4 @@
-from typing import ClassVar, Literal, NotRequired, TypedDict, Unpack, cast
+from typing import ClassVar, Literal, NotRequired, Optional, TypedDict, Unpack, cast
 
 from unique_sdk._api_resource import APIResource
 from unique_sdk._request_options import RequestOptions
@@ -8,11 +8,14 @@ class MessageLog(APIResource["MessageLog"]):
     OBJECT_NAME: ClassVar[Literal["message_log"]] = "message_log"
     RESOURCE_URL = "/message-log"
 
+    StatusLiteral = Literal["RUNNING", "COMPLETED", "FAILED"]
+
     class Reference(TypedDict):
         name: str
-        url: str | None
+        description: Optional[str]
+        url: Optional[str]
         sequenceNumber: int
-        originalIndex: list[int] | None
+        originalIndex: Optional[list[int]]
         sourceId: str
         source: str
 
@@ -23,7 +26,7 @@ class MessageLog(APIResource["MessageLog"]):
 
         messageId: str
         text: str
-        status: Literal["RUNNING", "COMPLETED", "FAILED"]
+        status: "MessageLog.StatusLiteral"
         order: int
         details: NotRequired[dict | None]
         uncitedReferences: NotRequired[dict | None]
@@ -35,21 +38,21 @@ class MessageLog(APIResource["MessageLog"]):
         """
 
         text: NotRequired[str | None]
-        status: NotRequired[Literal["RUNNING", "COMPLETED", "FAILED"] | None]
+        status: NotRequired["MessageLog.StatusLiteral | None"]
         order: NotRequired[int | None]
         details: NotRequired[dict | None]
         uncitedReferences: NotRequired[dict | None]
         references: NotRequired[list["MessageLog.Reference"] | None]
 
-    messageLogId: str | None
-    messageId: str | None
-    status: Literal["RUNNING", "COMPLETED", "FAILED"]
-    text: str | None
+    id: str
+    messageId: str
+    status: "MessageLog.StatusLiteral"
+    text: str
     details: dict
     uncitedReferences: dict
     order: int
     createdAt: str
-    updatedAt: str | None
+    updatedAt: str
 
     @classmethod
     def create(

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/api_resources/_space.py

@@ -35,9 +35,10 @@ class Space(APIResource["Space"]):
         """
 
         name: str
-        url: str | None
+        description: Optional[str]
+        url: Optional[str]
         sequenceNumber: int
-        originalIndex: List[int] | None
+        originalIndex: Optional[list[int]]
         sourceId: str
         source: str
 
@@ -69,7 +70,7 @@ class Space(APIResource["Space"]):
         chatId: str
         text: str | None
         originalText: str | None
-        role: Literal["system", "user", "assistant"]
+        role: Literal["SYSTEM", "USER", "ASSISTANT"]
         debugInfo: Optional[Dict[str, Any]]
         completedAt: str | None
         createdAt: str | None

{unique_sdk-0.10.32 → unique_sdk-0.10.38}/unique_sdk/utils/file_io.py

@@ -38,6 +38,7 @@ def upload_file(
     path_to_file,
     displayed_filename,
     mime_type,
+    description: Optional[str] = None,
     scope_or_unique_path=None,
     chat_id=None,
     ingestion_config: Optional[Content.IngestionConfig] = None,
@@ -55,6 +56,7 @@ def upload_file(
             "key": displayed_filename,
             "title": displayed_filename,
             "mimeType": mime_type,
+            "description": description,
             "ingestionConfig": ingestion_config,
             "metadata": metadata,
         },
@@ -83,6 +85,7 @@ def upload_file(
                 "key": displayed_filename,
                 "title": displayed_filename,
                 "mimeType": mime_type,
+                "description": description,
                 "byteSize": size,
                 "ingestionConfig": ingestion_config,
                 "metadata": metadata,
@@ -98,6 +101,7 @@ def upload_file(
                 "key": displayed_filename,
                 "title": displayed_filename,
                 "mimeType": mime_type,
+                "description": description,
                 "byteSize": size,
                 "ingestionConfig": ingestion_config,
                 "metadata": metadata,