unique_toolkit 2026.40.0.dev2__py3-none-any.whl → 2026.40.0.dev3__py3-none-any.whl

unique_toolkit/chat/functions.py

@@ -188,6 +188,46 @@ async def modify_message_async(
         raise e
 
 
+async def mark_turn_system_interrupted_async(
+    user_id: str,
+    company_id: str,
+    chat_id: str,
+    user_message_id: str,
+) -> ChatMessage:
+    """Marks the turn anchored on *user_message_id* as system-interrupted.
+
+    Persists ``turnInterruptionReason = SYSTEM_INTERRUPTED`` on the originating
+    USER message via a dedicated service-authenticated node-chat endpoint. The
+    server guarantees idempotency and never overwrites ``userAbortedAt`` (a
+    user-initiated stop wins if both race).
+
+    Args:
+        user_id (str): The user ID.
+        company_id (str): The company ID.
+        chat_id (str): The chat ID.
+        user_message_id (str): The originating USER message of the turn.
+
+    Returns:
+        ChatMessage: The USER message after the update (unchanged if the call
+            was a no-op due to idempotency or a racing user stop).
+
+    Raises:
+        Exception: If the request fails.
+
+    """
+    try:
+        message = await unique_sdk.Message.mark_turn_system_interrupted_async(
+            user_id=user_id,
+            company_id=company_id,
+            id=user_message_id,
+            chatId=chat_id,
+        )
+        return ChatMessage(**message)
+    except Exception as e:
+        _LOGGER.error(f"Failed to mark turn as system-interrupted: {e}")
+        raise e
+
+
 def map_references(references: list[ContentReference]) -> list[dict[str, Any]]:
     return [
         {

unique_toolkit/chat/schemas.py

@@ -192,6 +192,12 @@ class MessageLogStatus(StrEnum):
     RUNNING = "RUNNING"
     COMPLETED = "COMPLETED"
     FAILED = "FAILED"
+    CANCELLED = "CANCELLED"
+    """The user pressed Stop while this thinking/tool step was in flight.
+
+    Use ``FAILED`` for system-side interruption (timeout, truncation, terminal
+    backend failure), not for user-initiated cancellation.
+    """
 
 
 class MessageExecutionStatus(StrEnum):

unique_toolkit/services/chat_service.py

@@ -49,6 +49,7 @@ from unique_toolkit.chat.functions import (
     get_message_tools,
     get_message_tools_async,
     get_selection_from_history,
+    mark_turn_system_interrupted_async,
     modify_message,
     modify_message_assessment,
     modify_message_assessment_async,
@@ -383,6 +384,36 @@ class ChatService(ChatServiceDeprecated):
             set_completed_at=set_completed_at or False,
         )
 
+    async def mark_turn_system_interrupted_async(self) -> ChatMessage:
+        """Marks the current turn as system-interrupted.
+
+        Persists ``turnInterruptionReason = SYSTEM_INTERRUPTED`` on the current
+        chat context's originating USER message via a dedicated
+        service-authenticated node-chat endpoint.
+
+        Call this only for system-side unexpected endings: timeout, truncation,
+        terminal backend failure, and equivalents. Do not call it for
+        user-initiated cancellation or normal completion.
+
+        The operation is idempotent and never overwrites ``userAbortedAt``: if
+        the user pressed Stop and the system interruption race, the user stop
+        wins and this call is a server-side no-op.
+
+        Returns:
+            ChatMessage: The USER message anchoring the turn.
+
+        Raises:
+            Exception: If the request fails. Callers invoking this from
+                failure-handling paths should treat it as best-effort.
+
+        """
+        return await mark_turn_system_interrupted_async(
+            user_id=self._user_id,
+            company_id=self._company_id,
+            chat_id=self._chat_id,
+            user_message_id=self._user_message_id,
+        )
+
     def modify_assistant_message(
         self,
         content: str | None = None,

{unique_toolkit-2026.40.0.dev2.dist-info → unique_toolkit-2026.40.0.dev3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: unique-toolkit
-Version: 2026.40.0.dev2
+Version: 2026.40.0.dev3
 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.40.0.dev0,<2026.40.0rc0
+Requires-Dist: unique-sdk>=2026.40.0.dev3,<2026.40.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.40.0.dev2.dist-info → unique_toolkit-2026.40.0.dev3.dist-info}/RECORD

@@ -260,10 +260,10 @@ unique_toolkit/chat/cancellation.py,sha256=k5HMjpeBmofIiInwq5TjOR_5k91oq1bWG00lJ
 unique_toolkit/chat/constants.py,sha256=05kq6zjqUVB2d6_P7s-90nbljpB3ryxwCI-CAz0r2O4,83
 unique_toolkit/chat/deprecated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 unique_toolkit/chat/deprecated/service.py,sha256=8_XoopUWHT396Z_5gwMmsI6v4NGVgQirSJCYUW4Gx8c,9339
-unique_toolkit/chat/functions.py,sha256=1xpiRMTbl9XSz7fzzbUYYtsAa178bhZ0zIOAAzjDqQw,55773
+unique_toolkit/chat/functions.py,sha256=fb4x_y4d5QwT1WUjVEP-opFpJ9CV8WaiLAOR1ktTmy0,57073
 unique_toolkit/chat/rendering.py,sha256=c8YiV9oADRrJQ5A_QBJ4_UFc0NZ-2vVaa7tupoMusso,880
 unique_toolkit/chat/responses_api.py,sha256=Swp6wi10vCPkBiSSj8NN58gpjTgYVkqRlwdOJRQHVjo,21135
-unique_toolkit/chat/schemas.py,sha256=DJ3-J2a-FK45UU_H2NaDOh-H0UEsPgmM_5eGfwN3HfI,8123
+unique_toolkit/chat/schemas.py,sha256=tRU8vcT1SQWtktkHQmDO26CNbOgSynFHfFB9FR6D4OQ,8372
 unique_toolkit/chat/service.py,sha256=6D00OL4QrGafbOhTaC5zNXaNgg7gS5W_2ePVa4LhqpE,4439
 unique_toolkit/chat/state.py,sha256=Cjgwv_2vhDFbV69xxsn7SefhaoIAEqLx3ferdVFCnOg,1445
 unique_toolkit/chat/utils.py,sha256=CsD9IER2gA1IOV0fmUOl-N0LmKvA7JP9dGrOqeOY0Gg,1173
@@ -412,7 +412,7 @@ unique_toolkit/monitoring/registry.py,sha256=De2Bx5QBBRJQY2MM3xtntiJ2JU2FoKkVT7r
 unique_toolkit/monitoring/tracing.py,sha256=0lmLuQjyyC3iFpNTw8rOyCpEZ6PTvp16nVbzcO9d2sQ,10043
 unique_toolkit/protocols/support.py,sha256=x5edzbBmKAUuvm3oLFh52gkgQsqR5LU7M0t8RHK0DZk,5161
 unique_toolkit/services/__init__.py,sha256=b9Wl7Wvz1JmZDbDexIZzBoXZ0wscXuczGAH8LoL-Qak,572
-unique_toolkit/services/chat_service.py,sha256=8BncFKNJK0zR8QM3oFzUNdiPq5I4OLYbmQWJ06rIFTg,98932
+unique_toolkit/services/chat_service.py,sha256=umPHKDn0FX7vG7y7Tw-88iMultPpw_r0fYlhQlqvLYY,100196
 unique_toolkit/services/factory.py,sha256=7gNeanyHkgX23Iz7RMCQTCkE9gI5asCI11nXxM0jjx4,9832
 unique_toolkit/services/knowledge_base.py,sha256=6dM4abcXR9y2VYoR6SK79gwjrzb83Wm8jMPPIt5z95o,43461
 unique_toolkit/short_term_memory/__init__.py,sha256=2mI3AUrffgH7Yt-xS57EGqnHf7jnn6xquoKEhJqk3Wg,185
@@ -423,6 +423,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.40.0.dev2.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
-unique_toolkit-2026.40.0.dev2.dist-info/METADATA,sha256=1pYHcXpwHT_qaRtAktnTjSmPc8LuO6poU0Z1UiLbaRI,7821
-unique_toolkit-2026.40.0.dev2.dist-info/RECORD,,
+unique_toolkit-2026.40.0.dev3.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+unique_toolkit-2026.40.0.dev3.dist-info/METADATA,sha256=5lKBF9LaItGW_BMKf--Pm1cu_WyBA_yMPHpWd9XPrHs,7821
+unique_toolkit-2026.40.0.dev3.dist-info/RECORD,,