unique_sdk 0.10.32__tar.gz → 0.10.34__tar.gz

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

@@ -5,6 +5,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.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.34}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: unique_sdk
-Version: 0.10.32
+Version: 0.10.34
 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`.
 
@@ -890,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
 )
 ```
 
@@ -918,7 +917,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 +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.
@@ -1769,6 +1976,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.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.34}/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`.
 
@@ -872,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
 )
 ```
 
@@ -900,7 +899,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 +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.32 → unique_sdk-0.10.34}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "unique_sdk"
-version = "0.10.32"
+version = "0.10.34"
 description = ""
 authors = [
     "Martin Fadler <martin.fadler@unique.ch>",

{unique_sdk-0.10.32 → unique_sdk-0.10.34}/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.34}/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.32 → unique_sdk-0.10.34}/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