unique-toolkit 2026.34.0.dev13__tar.gz → 2026.34.0.dev15__tar.gz

{unique_toolkit-2026.34.0.dev13 → unique_toolkit-2026.34.0.dev15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.34.0.dev13
+Version: 2026.34.0.dev15
 Summary: 
 Author: Cedric Klinkert, Martin Fadler, Sadique Sheik, Fabian Schläpfer, Pascal Hauri, Ejiroghene Oki-Peter, Rami Azouz, Ricardo Visini, Sanzio Monti
 Author-email: Cedric Klinkert <cedric.klinkert@unique.ch>, Martin Fadler <martin.fadler@unique.ch>, Sadique Sheik <sadique@unique.ch>, Fabian Schläpfer <fabian@unique.ch>, Pascal Hauri <pascal@unique.ch>, Ejiroghene Oki-Peter <oki-peter.ejiroghene@unique.ai>, Rami Azouz <rami.ext@unique.ch>, Ricardo Visini <ricardo.visini@unique.ch>, Sanzio Monti <sanzio.monti@unique.ai>
@@ -16,7 +16,7 @@ Requires-Dist: sseclient>=0.0.27,<0.0.28
 Requires-Dist: openai>=1.105.0,<3
 Requires-Dist: platformdirs>=4.0.0,<5
 Requires-Dist: pillow>=12.1.1
-Requires-Dist: unique-sdk>=2026.34.0.dev5,<2026.34.0rc0
+Requires-Dist: unique-sdk>=2026.34.0.dev7,<2026.34.0rc0
 Requires-Dist: jambo>=0.1.2,<0.2
 Requires-Dist: jinja2>=3.1.6,<4
 Requires-Dist: docxtpl>=0.20.1,<0.21

{unique_toolkit-2026.34.0.dev13 → unique_toolkit-2026.34.0.dev15}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "unique_toolkit"
-version = "2026.34.0.dev13"
+version = "2026.34.0.dev15"
 description = ""
 readme = "README.md"
 requires-python = ">=3.12"
@@ -28,7 +28,7 @@ dependencies = [
     "openai>=1.105.0,<3",
     "platformdirs>=4.0.0,<5",
     "pillow>=12.1.1",
-    "unique-sdk>=2026.34.0.dev5,<2026.34.0rc0",
+    "unique-sdk>=2026.34.0.dev7,<2026.34.0rc0",
     "jambo>=0.1.2,<0.2",
     "jinja2>=3.1.6,<4",
     "docxtpl>=0.20.1,<0.21",

{unique_toolkit-2026.34.0.dev13 → unique_toolkit-2026.34.0.dev15}/unique_toolkit/agentic_table/__init__.py

@@ -32,6 +32,7 @@ from .schemas import (
     MagicTableUpdateCellPayload,
     RerunRowMetadata,
     RowMetadataEntry,
+    RowMetadataEntryInput,
     SelectionMethod,
     SheetMetadataEntryInput,
     SheetType,
@@ -79,6 +80,7 @@ __all__ = [
     "MagicTableUpdateCellPayload",
     "RerunRowMetadata",
     "RowMetadataEntry",
+    "RowMetadataEntryInput",
     "RowVerificationStatus",
     "SelectionMethod",
     "SheetMetadataEntryInput",

{unique_toolkit-2026.34.0.dev13 → unique_toolkit-2026.34.0.dev15}/unique_toolkit/agentic_table/schemas.py

@@ -363,6 +363,11 @@ class MagicTableCellMetaData(BaseModel):
 class MagicTableCell(BaseModel):
     model_config = get_configuration_dict()
     sheet_id: str
+    row_id: str | None = Field(
+        default=None,
+        alias="rowId",
+        description="The backend id of the row this cell belongs to (needed to write row metadata).",
+    )
     row_order: int = Field(description="The row index of the cell.")
     column_order: int = Field(description="The column index of the cell.")
     row_locked: bool = Field(default=False, description="Lock status of the row.")
@@ -452,3 +457,19 @@ class SheetMetadataEntryInput(BaseModel):
         default=False,
         description="Whether the metadata is to be used for strict filtering",
     )
+
+
+class RowMetadataEntryInput(BaseModel):
+    """Input entry for creating row metadata (key/value pairs) on a row.
+
+    Distinct from :class:`RowMetadataEntry`, the read shape, which carries the
+    server-assigned ``id``. Ids are never accepted on create.
+    """
+
+    model_config = get_configuration_dict()
+    key: str
+    value: str
+    exact_filter: bool = Field(
+        default=False,
+        description="Whether the metadata is to be used for strict filtering",
+    )

{unique_toolkit-2026.34.0.dev13 → unique_toolkit-2026.34.0.dev15}/unique_toolkit/agentic_table/service.py

@@ -17,7 +17,10 @@ from unique_sdk import (
     SelectionMethod,
 )
 from unique_sdk import AgenticTableCell as SDKAgenticTableCell
-from unique_sdk.api_resources._agentic_table import ActivityStatus
+from unique_sdk.api_resources._agentic_table import (
+    ActivityStatus,
+    MagicTableMetadataEntry,
+)
 
 from .schemas import (
     CreatedMagicTableSheet,
@@ -27,6 +30,7 @@ from .schemas import (
     MagicTableCell,
     MagicTableSheet,
     RowMetadataEntry,
+    RowMetadataEntryInput,
     SheetMetadataEntryInput,
 )
 
@@ -439,7 +443,6 @@ class AgenticTableService:
         include_log_history: bool = False,
         include_cell_meta_data: bool = False,
         include_row_metadata: bool = False,
-        scope_to_assigned_rows: bool = False,
     ) -> MagicTableSheet:
         """
         Gets the sheet data from the Agentic Table paginated by batch_size.
@@ -451,8 +454,6 @@ class AgenticTableService:
             include_log_history (bool): Whether to include the log history.
             include_cell_meta_data (bool): Whether to include the cell metadata (renderer, selection, agreement status).
             include_row_metadata (bool): Whether to include the row metadata (key value pairs).
-            scope_to_assigned_rows (bool): When true, scope row count and cell batches to rows
-                assigned to the current user (Can Answer role).
         Returns:
             MagicTableSheet: The sheet data.
         """
@@ -465,7 +466,6 @@ class AgenticTableService:
             includeCells=False,
             includeLogHistory=False,
             includeCellMetaData=False,
-            scopeToAssignedRows=scope_to_assigned_rows,
         )
         total_rows = sheet_info.get("magicTableRowCount")
         if total_rows is None:
@@ -495,7 +495,6 @@ class AgenticTableService:
                     startRow=row,
                     endRow=end_row_batch - 1,
                     includeRowMetadata=True,
-                    scopeToAssignedRows=scope_to_assigned_rows,
                 )
             else:
                 sheet_partial = await AgenticTable.get_sheet_data(
@@ -508,7 +507,6 @@ class AgenticTableService:
                     includeCellMetaData=include_cell_meta_data,  # renderer, selection, agreement status
                     startRow=row,
                     endRow=end_row_batch - 1,
-                    scopeToAssignedRows=scope_to_assigned_rows,
                 )
             if "magicTableCells" in sheet_partial:
                 batch_cells = sheet_partial["magicTableCells"]
@@ -771,6 +769,63 @@ class AgenticTableService:
         if not result.get("status"):
             raise Exception(result.get("message") or "Failed to create sheet metadata")
 
+    async def create_row_metadata(
+        self,
+        row: int,
+        entries: list[RowMetadataEntryInput],
+        row_id: str | None = None,
+    ) -> None:
+        """Create key/value row metadata for a single row, addressed by row order.
+
+        Row metadata is the per-row key/value store surfaced by the agentic
+        table's row-metadata UI and forwarded onto knowledge-base content at
+        add-to-library time. The backend endpoint addresses rows by their id, not
+        their order, so unless ``row_id`` is given the id is resolved from column
+        ``0`` of the row first (mirrors ``get_row_metadata`` read helpers).
+
+        NOTE: not to be confused with ``set_cell_metadata`` (selection /
+        agreement status) or ``create_sheet_metadata`` (sheet-level metadata).
+
+        Args:
+            row (int): The row index (row order).
+            entries (list[RowMetadataEntryInput]): Key/value entries to create.
+                Empty is a no-op.
+            row_id (str | None): The backend row id, when the caller already has
+                it. Callers writing many rows should read the range once (cells
+                carry ``rowId``) and pass it, rather than paying a ``get_cell``
+                round trip per row.
+
+        Raises:
+            ValueError: If the row id cannot be resolved from the row.
+            Exception: If the API reports a non-success status.
+        """
+        if not entries:
+            return
+        if row_id is None:
+            cell = await self.get_cell(row, 0, include_row_metadata=False)
+            row_id = cell.row_id
+        if not row_id:
+            raise ValueError(
+                f"Cannot write row metadata: row {row} has no resolvable row id "
+                f"on table {self.table_id}."
+            )
+        result = await AgenticTable.create_row_metadata(
+            user_id=self._user_id,
+            company_id=self._company_id,
+            tableId=self.table_id,
+            rowId=row_id,
+            entries=[
+                MagicTableMetadataEntry(
+                    key=entry.key,
+                    value=entry.value,
+                    exactFilter=entry.exact_filter,
+                )
+                for entry in entries
+            ],
+        )
+        if not result.get("status"):
+            raise Exception(result.get("message") or "Failed to create row metadata")
+
     async def delete_sheet_metadata(self, metadata_id: str) -> None:
         """Delete a sheet metadata entry by its id.