unique_toolkit 2026.42.0.dev7__py3-none-any.whl → 2026.42.0.dev8__py3-none-any.whl

unique_toolkit/agentic_table/service.py

@@ -1,6 +1,7 @@
 import asyncio
 import logging
 import time
+from collections.abc import Collection
 from datetime import datetime
 from typing import Any, NamedTuple, cast
 
@@ -252,7 +253,11 @@ class AgenticTableService:
         return MagicTableCell.model_validate(cell_data)
 
     async def set_multiple_cells(
-        self, cells: list[MagicTableCell], batch_size: int = 4000
+        self,
+        cells: list[MagicTableCell],
+        batch_size: int = 4000,
+        *,
+        overwrite_library_rows: bool | None = None,
     ):
         """
         Sets the values of multiple cells in the Agentic Table.
@@ -260,6 +265,14 @@ class AgenticTableService:
         Args:
             cells (list[MagicTableCell]): The cells to set sorted by row and column.
             batch_size (int): Number of cells to set in a single request.
+            overwrite_library_rows (bool | None): When set, forwarded as
+                ``overwriteLibraryRows``. ``True`` lets updates to existing cells on
+                library-sheet rows go through instead of being dropped; the server
+                only honors it on library sheets, for rows where the caller can read
+                every sheet named in the row's ``sourceSheetId`` metadata. Locked rows still
+                need unlocking first (``update_row_verification_status`` with
+                ``locked=False``). ``None`` omits the field; servers that predate
+                it reject it with a 400.
         """
         for i in range(0, len(cells), batch_size):
             batch = cells[i : i + batch_size]
@@ -275,6 +288,7 @@ class AgenticTableService:
                     )
                     for cell in batch
                 ],
+                overwriteLibraryRows=overwrite_library_rows,
             )
 
     async def set_activity(
@@ -875,6 +889,133 @@ class AgenticTableService:
         if not result.get("status"):
             raise Exception(result.get("message") or "Failed to create row metadata")
 
+    async def update_row_metadata(
+        self,
+        metadata_id: str,
+        entry: RowMetadataEntryInput,
+    ) -> None:
+        """Update a single row metadata entry, addressed by its id.
+
+        Args:
+            metadata_id (str): The ``id`` of the row metadata entry to update.
+            entry (RowMetadataEntryInput): The new key, value and filter flag.
+
+        Raises:
+            Exception: If the API reports a non-success status.
+        """
+        result = await AgenticTable.update_row_metadata(
+            user_id=self._user_id,
+            company_id=self._company_id,
+            tableId=self.table_id,
+            metadataId=metadata_id,
+            key=entry.key,
+            value=entry.value,
+            exactFilter=entry.exact_filter,
+        )
+        if not result.get("status"):
+            raise Exception(result.get("message") or "Failed to update row metadata")
+
+    async def delete_row_metadata(self, metadata_id: str) -> None:
+        """Delete a single row metadata entry, addressed by its id.
+
+        Raises:
+            Exception: If the API reports a non-success status.
+        """
+        result = await AgenticTable.delete_row_metadata(
+            user_id=self._user_id,
+            company_id=self._company_id,
+            tableId=self.table_id,
+            metadataId=metadata_id,
+        )
+        if not result.get("status"):
+            raise Exception(result.get("message") or "Failed to delete row metadata")
+
+    async def set_row_metadata_by_key(
+        self,
+        row: int,
+        entries: list[RowMetadataEntryInput],
+        row_id: str | None = None,
+        existing: list[RowMetadataEntry] | None = None,
+        managed_keys: Collection[str] | None = None,
+    ) -> None:
+        """Merge row metadata by key, and optionally remove keys the caller owns.
+
+        For each entry: a key the row lacks is created; a key the row holds with
+        a different value or filter flag is updated in place; a key that already
+        matches is left alone. If the row holds the key more than once, one entry
+        is kept and the others are deleted, so the key ends up with exactly the
+        given value.
+
+        Keys not in ``entries`` are only removed when listed in ``managed_keys``.
+        This is not a full replace: rows also carry metadata the caller does not
+        own (e.g. the ``sourceSheetId`` stamp that library overwrites are checked
+        against), which must survive.
+
+        Args:
+            row (int): The row index (row order).
+            entries (list[RowMetadataEntryInput]): Key/value entries to set. Keys
+                must be unique.
+            row_id (str | None): The backend row id, used when creating keys.
+            existing (list[RowMetadataEntry] | None): The row's current metadata,
+                when the caller already read it (e.g. ``get_sheet`` with
+                ``include_row_metadata=True``). When ``None``, the row's metadata
+                and id are read with ``get_cell``.
+            managed_keys (Collection[str] | None): Keys the caller owns. Every
+                entry key must be in it. Any of these keys missing from
+                ``entries`` is deleted from the row, duplicates included. ``None``
+                deletes nothing beyond duplicates of keys in ``entries``.
+
+        Raises:
+            ValueError: If ``entries`` repeats a key, an entry key is not in
+                ``managed_keys``, or a key must be created and the row id cannot
+                be resolved.
+            Exception: If the API reports a non-success status.
+        """
+        keys = [entry.key for entry in entries]
+        if len(set(keys)) != len(keys):
+            raise ValueError(f"Duplicate row metadata keys in {keys}")
+        if managed_keys is not None:
+            unmanaged = sorted(set(keys) - set(managed_keys))
+            if unmanaged:
+                raise ValueError(f"Row metadata keys {unmanaged} not in managed_keys")
+        if not entries and not managed_keys:
+            return
+        if existing is None:
+            cell = await self.get_cell(row, 0, include_row_metadata=True)
+            existing = cell.row_metadata
+            row_id = row_id or cell.row_id
+
+        existing_by_key: dict[str, list[RowMetadataEntry]] = {}
+        for current in existing:
+            existing_by_key.setdefault(current.key, []).append(current)
+
+        to_create: list[RowMetadataEntryInput] = []
+        for entry in entries:
+            matches = existing_by_key.get(entry.key)
+            if not matches:
+                to_create.append(entry)
+                continue
+            keep = next(
+                (
+                    m
+                    for m in matches
+                    if m.value == entry.value and m.exact_filter == entry.exact_filter
+                ),
+                None,
+            )
+            if keep is None:
+                keep = matches[0]
+                await self.update_row_metadata(keep.id, entry)
+            for duplicate in matches:
+                if duplicate.id != keep.id:
+                    await self.delete_row_metadata(duplicate.id)
+
+        for key in set(managed_keys or ()) - set(keys):
+            for stale in existing_by_key.get(key, []):
+                await self.delete_row_metadata(stale.id)
+
+        await self.create_row_metadata(row, to_create, row_id=row_id)
+
     async def delete_sheet_metadata(self, metadata_id: str) -> None:
         """Delete a sheet metadata entry by its id.
 

{unique_toolkit-2026.42.0.dev7.dist-info → unique_toolkit-2026.42.0.dev8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.42.0.dev7
+Version: 2026.42.0.dev8
 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.42.0.dev1,<2026.42.0rc0
+Requires-Dist: unique-sdk>=2026.42.0.dev3,<2026.42.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.42.0.dev7.dist-info → unique_toolkit-2026.42.0.dev8.dist-info}/RECORD

@@ -242,7 +242,7 @@ unique_toolkit/agentic/tools/utils/source_handling/source_formatting.py,sha256=u
 unique_toolkit/agentic/tools/utils/source_handling/tests/test_source_formatting.py,sha256=EA8iVvb3L91OFk2XMbGcFuhe2etqm3Sx9QCYDGiOSOM,6995
 unique_toolkit/agentic_table/__init__.py,sha256=RwBShHaD15R3117mU3ZLVzjgPz2ngdbzif7WJwhm8zw,2552
 unique_toolkit/agentic_table/schemas.py,sha256=hi4vUn95ct2dm3nbkvke7j8RVVCp_nTlzSzLro1OT34,18663
-unique_toolkit/agentic_table/service.py,sha256=An2D701eGdUTCaZYHZHQEZsHe50PlDw3yKEK5ypCD-g,42891
+unique_toolkit/agentic_table/service.py,sha256=_aDjxux1Dvdf11-jHzVvEw0PSDNDSjZ-DzKuoxJd09Y,49059
 unique_toolkit/agentic_table/synthetic_chat_event.py,sha256=MylvYuhx5CVt2DbPetzV0sR8GlkL218DmNFi7A6RYVs,2373
 unique_toolkit/app/__init__.py,sha256=qear5ErW3smLDATxtnUsgkX3f177zsn65ixVW8T0JVE,1641
 unique_toolkit/app/chat_event_filter_options_settings.py,sha256=W0Ydio1UeED5_xqaTzbcGzK2tH4EpA1WHUzdF-iWpqI,364
@@ -426,6 +426,6 @@ unique_toolkit/short_term_memory/service.py,sha256=2JMBEBn6GoyK-a0xvdcWpPft-3C74
 unique_toolkit/smart_rules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_toolkit/smart_rules/compile.py,sha256=vRe0aMJWuVIK-VsqomgxQImzke7MDmwgSxxJfYCa7zw,1386
 unique_toolkit/test_utilities/events.py,sha256=FLrhMh0A_mQutAUjoD0FdMcVQ4Gq31r35OVGzRjvLro,6760
-unique_toolkit-2026.42.0.dev7.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-unique_toolkit-2026.42.0.dev7.dist-info/METADATA,sha256=lerw6mdP9Cp9f4mxf3nMFsJEZg9R_iak69i2o-uZcwU,7821
-unique_toolkit-2026.42.0.dev7.dist-info/RECORD,,
+unique_toolkit-2026.42.0.dev8.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+unique_toolkit-2026.42.0.dev8.dist-info/METADATA,sha256=ahv1aNL9F18iHC057Ry2rFbO6X6zaOb1-TZ080dzbSg,7821
+unique_toolkit-2026.42.0.dev8.dist-info/RECORD,,