unique_sdk 0.10.31__tar.gz → 0.10.36__tar.gz

{unique_sdk-0.10.31 → unique_sdk-0.10.36}/CHANGELOG.md

@@ -5,6 +5,21 @@ 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.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.
+
 ## [0.10.31] - 2025-10-13
 - Add readme for message log and execution.
 

{unique_sdk-0.10.31 → unique_sdk-0.10.36}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.31
+Version: 0.10.36
 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`.
 
@@ -700,6 +702,26 @@ message = unique_sdk.Message.create(
 )
 ```
 
+#### `unique_sdk.Message.create_event`
+
+Create a new message event in a chat. Updating the text of a message in the chat UI is possible by creating a message update event. This function can be used for custom streaming to the chat. (Compatible with release >.42)
+
+The event only changes the text in the UI, it *does not* update the database.
+
+```python
+message = unique_sdk.Message.create_event(
+    user_id=user_id,
+    company_id=company_id,
+    messageId="msg_l4ushn85yqbewpf6tllh2cl7",
+    chatId="chat_kc8p3kgkn7393qhgmv5js5nt",
+    text="Hello.",                  #optional
+    originalText="Hello.",          #optional
+    references=[],                  #optional
+    gptRequest={}                   #optional
+    debugInfo={  "hello": "test" }, #optional
+)
+```
+
 #### `unique_sdk.Message.modify`
 
 Modify an existing chat message.
@@ -825,7 +847,7 @@ unique_sdk.Integrated.responses_stream(
 
 #### `unique_sdk.MessageLog.create`
 
-Create a message log for a provided `messageId`.
+Function to update the steps section of a message in the chat UI. This is possible by creating a message log record during a message execution.
 
 ```python
 msg_log = unique_sdk.MessageLog.create(
@@ -834,10 +856,10 @@ msg_log = unique_sdk.MessageLog.create(
     messageId="msg_a0jgnt1jrqv1d3uzr450waxw",
     text="Create message log text",
     order=1,
-    status="RUNNING",                               # one of "RUNNING", "COMPLETED", "FAILED"
-    details=None,                                   # optional, details dictionary
-    uncitedReferences=None,                         # optional, references dictionary
-    references=None,                                # optional, list of references
+    status="RUNNING",                             # one of "RUNNING", "COMPLETED", "FAILED"
+    details={},                                   # optional, details dictionary
+    uncitedReferences={},                         # optional, references dictionary
+    references=[],                                # optional, list of references
 )
 ```
 
@@ -850,12 +872,12 @@ msg_log = unique_sdk.MessageLog.update(
     user_id=user_id,
     company_id=company_id,
     message_log_id="message_log_fd7z7gjljo1z2wu5g6l9q7r9",
-    text="Update a message log text",               # optional
-    order=1,                                        # optional
-    status="RUNNING",                               # one of "RUNNING", "COMPLETED", "FAILED"
-    details=None,                                   # optional, details dictionary
-    uncitedReferences=None,                         # optional, references dictionary
-    references=None,                              
+    text="Update a message log text",             # optional
+    order=1,                                      # optional
+    status="RUNNING",                             # one of "RUNNING", "COMPLETED", "FAILED"
+    details={},                                   # optional, details dictionary
+    uncitedReferences={},                         # optional, references dictionary
+    references=[],                                # optional, list of references
 )
 ```
 
@@ -870,10 +892,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
+    type="DEEP_RESEARCH",
 )
 ```
 
@@ -898,9 +917,9 @@ msg_execution = unique_sdk.MessageExecution.update(
     user_id=user_id,
     company_id=company_id,
     messageId="msg_a0jgnt1jrqv143uzr750waxw",
-    status="COMPLETED",                       # one of: COMPLETED, FAILED
-    secondsRemaining=55                       # optional, number defining the seconds remaining
-    percentageCompleted=10                    # optional, number defining the percentage completed
+    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
 )
 ```
 
@@ -1352,6 +1371,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.
@@ -1749,6 +1976,21 @@ 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.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.
+
 ## [0.10.31] - 2025-10-13
 - Add readme for message log and execution.
 

{unique_sdk-0.10.31 → unique_sdk-0.10.36}/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`.
 
@@ -682,6 +684,26 @@ message = unique_sdk.Message.create(
 )
 ```
 
+#### `unique_sdk.Message.create_event`
+
+Create a new message event in a chat. Updating the text of a message in the chat UI is possible by creating a message update event. This function can be used for custom streaming to the chat. (Compatible with release >.42)
+
+The event only changes the text in the UI, it *does not* update the database.
+
+```python
+message = unique_sdk.Message.create_event(
+    user_id=user_id,
+    company_id=company_id,
+    messageId="msg_l4ushn85yqbewpf6tllh2cl7",
+    chatId="chat_kc8p3kgkn7393qhgmv5js5nt",
+    text="Hello.",                  #optional
+    originalText="Hello.",          #optional
+    references=[],                  #optional
+    gptRequest={}                   #optional
+    debugInfo={  "hello": "test" }, #optional
+)
+```
+
 #### `unique_sdk.Message.modify`
 
 Modify an existing chat message.
@@ -807,7 +829,7 @@ unique_sdk.Integrated.responses_stream(
 
 #### `unique_sdk.MessageLog.create`
 
-Create a message log for a provided `messageId`.
+Function to update the steps section of a message in the chat UI. This is possible by creating a message log record during a message execution.
 
 ```python
 msg_log = unique_sdk.MessageLog.create(
@@ -816,10 +838,10 @@ msg_log = unique_sdk.MessageLog.create(
     messageId="msg_a0jgnt1jrqv1d3uzr450waxw",
     text="Create message log text",
     order=1,
-    status="RUNNING",                               # one of "RUNNING", "COMPLETED", "FAILED"
-    details=None,                                   # optional, details dictionary
-    uncitedReferences=None,                         # optional, references dictionary
-    references=None,                                # optional, list of references
+    status="RUNNING",                             # one of "RUNNING", "COMPLETED", "FAILED"
+    details={},                                   # optional, details dictionary
+    uncitedReferences={},                         # optional, references dictionary
+    references=[],                                # optional, list of references
 )
 ```
 
@@ -832,12 +854,12 @@ msg_log = unique_sdk.MessageLog.update(
     user_id=user_id,
     company_id=company_id,
     message_log_id="message_log_fd7z7gjljo1z2wu5g6l9q7r9",
-    text="Update a message log text",               # optional
-    order=1,                                        # optional
-    status="RUNNING",                               # one of "RUNNING", "COMPLETED", "FAILED"
-    details=None,                                   # optional, details dictionary
-    uncitedReferences=None,                         # optional, references dictionary
-    references=None,                              
+    text="Update a message log text",             # optional
+    order=1,                                      # optional
+    status="RUNNING",                             # one of "RUNNING", "COMPLETED", "FAILED"
+    details={},                                   # optional, details dictionary
+    uncitedReferences={},                         # optional, references dictionary
+    references=[],                                # optional, list of references
 )
 ```
 
@@ -852,10 +874,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
+    type="DEEP_RESEARCH",
 )
 ```
 
@@ -880,9 +899,9 @@ msg_execution = unique_sdk.MessageExecution.update(
     user_id=user_id,
     company_id=company_id,
     messageId="msg_a0jgnt1jrqv143uzr750waxw",
-    status="COMPLETED",                       # one of: COMPLETED, FAILED
-    secondsRemaining=55                       # optional, number defining the seconds remaining
-    percentageCompleted=10                    # optional, number defining the percentage completed
+    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
 )
 ```
 
@@ -1334,6 +1353,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.31 → unique_sdk-0.10.36}/pyproject.toml

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

{unique_sdk-0.10.31 → unique_sdk-0.10.36}/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.31 → unique_sdk-0.10.36}/unique_sdk/api_resources/_message.py

@@ -59,6 +59,16 @@ class Message(APIResource["Message"]):
     class RetrieveParams(RequestOptions):
         chatId: str
 
+    class CreateEventParams(RequestOptions):
+        messageId: str
+        chatId: str
+        originalText: NotRequired[str | None]
+        text: NotRequired[str | None]
+        references: NotRequired[List["Message.Reference"] | None]
+        gptRequest: NotRequired[Dict[str, Any] | None]
+        debugInfo: NotRequired[Dict[str, Any] | None]
+        completedAt: NotRequired[datetime | None]
+
     chatId: str
     text: Optional[str]
     role: Literal["SYSTEM", "USER", "ASSISTANT"]
@@ -303,3 +313,49 @@ class Message(APIResource["Message"]):
             company_id,
             params=params,
         )
+
+    @classmethod
+    def create_event(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Message.CreateEventParams"],
+    ) -> "Message":
+        """
+        Creates a new message event object.
+        """
+        message_id = params.get("messageId")
+        params.pop("messageId", None)
+        return cast(
+            "Message",
+            cls._static_request(
+                "post",
+                f"{cls.class_url()}/{message_id}/event",
+                user_id,
+                company_id,
+                params,
+            ),
+        )
+
+    @classmethod
+    async def create_event_async(
+        cls,
+        user_id: str,
+        company_id: str,
+        **params: Unpack["Message.CreateEventParams"],
+    ) -> "Message":
+        """
+        Creates a new message event object.
+        """
+        message_id = params.get("messageId")
+        params.pop("messageId", None)
+        return cast(
+            "Message",
+            await cls._static_request_async(
+                "post",
+                f"{cls.class_url()}/{message_id}/event",
+                user_id,
+                company_id,
+                params,
+            ),
+        )

{unique_sdk-0.10.31 → unique_sdk-0.10.36}/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.31 → unique_sdk-0.10.36}/unique_sdk/api_resources/_message_log.py

@@ -8,6 +8,8 @@ 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
@@ -23,7 +25,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 +37,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.31 → unique_sdk-0.10.36}/unique_sdk/api_resources/_space.py

@@ -69,7 +69,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